context-param必须作为web-app的直接子元素置于正确位置，否则ServletContext.getInitParameter()无法获取；常见错误是嵌套在servlet或filter内、顺序错位、未声明XML命名空间或schemaLocation、web.xml路径错误、Spring Boot中被忽略。
web.xml里context-param必须放在<web-app></web-app>直接子元素位置
放错位置会导致参数完全不生效，连ServletContext.getInitParameter()都拿不到值。常见错误是把它塞进<servlet></servlet>或<filter></filter>块里，或者放在<listener></listener>后面但没注意DTD/XSD声明顺序。
标准位置在<web-app></web-app>开头几个配置项之后、<servlet></servlet>之前（具体顺序需符合所用Servlet规范版本的DTD要求）：
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
<context-param>
<param-name>app.env</param-name>
<param-value>prod</param-value>
</context-param>
<servlet>...</servlet>
</web-app>
- Servlet 3.0+ 的
web.xml必须声明version="3.0"或更高，否则context-param可能被忽略 - 多个
context-param可以并列，但param-name不能重复，重复时以最后出现的为准 - 如果同时用了
@WebListener和web.xml，监听器类里的contextInitialized()才能读到这些参数
读取context-param要用ServletContext.getInitParameter()
不是getInitParameterNames()或getAttribute()，也不是从HttpServletRequest里取——它只属于ServletContext生命周期。
典型用法是在ServletContextListener中初始化全局配置：
public class AppConfigListener implements ServletContextListener {
public void contextInitialized(ServletContextEvent sce) {
ServletContext ctx = sce.getServletContext();
String env = ctx.getInitParameter("app.env"); // ← 正确
if ("dev".equals(env)) {
ctx.setAttribute("logLevel", "DEBUG");
}
}
}
- 在
Filter或Servlet中获取时，必须通过getServletContext()方法拿到上下文实例 - 如果
param-value含空格或特殊字符，XML会自动解析，无需额外trim或转义 - 值为
null只有一种情况：名字拼错，或web.xml根本没加载（比如路径不对、文件名大小写错误）
Tomcat下context-param不生效的三个高频原因
本地跑得好，部署到Tomcat就拿不到值，大概率不是代码问题，而是环境配置偏差。
-
web.xml不在WEB-INF/目录下，或者被IDE误编译进了classes/而不是保留原结构 - Tomcat启动时实际加载的是
$CATALINA_BASE/conf/web.xml（全局配置），而非应用自己的WEB-INF/web.xml——检查日志里有没有Deploying web application directory这类提示 - 用了Spring Boot内嵌Tomcat，此时
web.xml默认被忽略，得改用ServletWebServerFactory或@Bean ServletWebServerFactory方式注册
验证是否加载成功：在ServletContextListener.contextInitialized()里加日志，打印ctx.getInitParameterNames()枚举结果。
context-param vs init-param别混用
一个管整个Web应用，一个只管单个Servlet，作用域和读取方式完全不同。
-
context-param：写在<web-app></web-app>下，用ServletContext.getInitParameter()读 -
init-param：写在<servlet></servlet>内部，用ServletConfig.getInitParameter()读，且仅该Servlet能访问 - 别指望在
Filter里用getInitParameter()读context-param——它没有这个方法，必须先调getServletContext()
名字相同也不会覆盖：context-param的app.env和某个servlet的init-param叫app.env，是两个独立变量。
web.xml的XML namespace和schemaLocation声明——缺了它，旧版Tomcat可能静默降级解析，新版则直接报错跳过整个文件。写完记得用IDE校验XML有效性。 
