context-param的param-name写错会导致ServletContext.getInitParameter()返回null且无警告；常见错误包括空格、大小写不一致、非法字符；建议统一小写加连字符命名并添加初始化校验。
web.xml 里 context-param 的 param-name 写错会怎样
直接后果：对应 ServletContext.getInitParameter("xxx") 返回 null，且毫无警告。不是报错，不是日志，就是“查无此参”——尤其容易在切换环境或重构配置时漏掉拼写一致性。
常见错误现象：
-
param-name多了个空格，比如app.version（末尾空格） - 大小写不一致，Java 代码里写
AppVersion，XML 里却是appversion - 用了保留字或非法字符，如
class、xml:lang，部分容器会静默忽略
实操建议：
- 所有
param-name统一用小写字母 + 连字符，例如feature.flag.enable-cache，和 Spring Boot 的application.properties风格对齐，减少跨框架认知成本 - 在 Servlet 初始化时加一行校验：
if (getServletContext().getInitParameter("db.url") == null) throw new IllegalStateException("Missing required context-param: db.url"); - 避免在
param-name中使用点号（.）开头或结尾，某些老版本 Tomcat 会截断
Spring 应用里还该用 context-param 吗
要看你用的是哪种 Spring 启动方式。传统 web.xml + ContextLoaderListener 时，它仍是加载根应用上下文的唯一入口；但用了 Spring Boot 或 Servlet 3.0+ 的编程式注册后，context-param 就退居二线，甚至可能被完全绕过。
使用场景对比：
- 需要被多个 Servlet 共享的全局配置（如数据库连接池参数），且不希望耦合到某个具体 Servlet 的
init-param中 → 适合context-param - 只想给 Spring MVC 的
DispatcherServlet用的配置（如contextConfigLocation）→ 更推荐用servlet标签下的init-param，作用域更精准 - Spring Boot 默认不读
web.xml，哪怕你写了context-param，除非显式启用传统部署模式（SpringBootServletInitializer）
性能影响很小，但多一层 XML 解析和字符串映射；兼容性上，所有 Servlet 2.5+ 容器都支持，包括 Jetty 9、Tomcat 7+、WildFly。
param-value 里写路径或表达式要注意什么
值本身不会被解析，param-value 是纯字符串。所谓“路径”只是你传进去的一个文本，容器不会校验它是否存在、是否可读、是否是绝对路径。
容易踩的坑：
-
param-value写成相对路径如WEB-INF/config/app.properties，但实际调用方（比如自定义ServletContextListener）没拼对上下文路径，导致getRealPath()返回null - 值里含 XML 特殊字符（
&、、<code>>）没转义，导致 web.xml 解析失败，整个应用启动不了 —— 错误信息通常是 “cvc-complex-type.2.4.a: Invalid content was found starting with element 'param-value'” - 想用系统属性占位符如
${user.home}？不行。context-param不支持 EL 或 Spring 占位符，那是 Spring 框架层做的事
实操建议：
- 路径类值统一用斜杠开头，如
/WEB-INF/config/，然后在代码里用getRealPath("/WEB-INF/config/")获取物理路径 - 必须含特殊字符时，用
&、<、>替代 - 敏感值（如密钥）别硬编码进
param-value，改用外部化配置或 JNDI 查找
多个 context-param 的加载顺序有影响吗
没有。Servlet 规范没定义顺序语义，ServletContext.getInitParameterNames() 返回的是 Enumeration，遍历顺序取决于具体容器实现（Tomcat 通常按 XML 出现顺序，Jetty 可能按哈希顺序），不可依赖。
所以：
- 不要写逻辑依赖 A 参数一定在 B 参数之前初始化 —— 它们是并行注入的键值对，不是执行语句
- 如果两个参数共同决定一个行为（比如
cache.enabled和cache.ttl.seconds），应在使用前做完整校验，而不是假设先读到前者再读后者 - IDE 或 XML 校验器可能按文档顺序提示，但这和运行时无关；真正要控制初始化时机，得靠
ServletContextListener.contextInitialized()里的代码顺序
最常被忽略的一点：容器启动时，context-param 是最早可用的配置机制之一，但它不参与 Spring Bean 的 @Value 注入自动绑定 —— 除非你显式配置了 PropertyPlaceholderConfigurer 或用 @PropertySource 引入 ServletContext 上下文参数。这点很多人以为写了就能直接 @Value("${db.url}")，结果是空指针。
