web.xml 不支持 ${env_var} 是因为其解析器不执行 el 表达式或系统属性替换，仅做静态字面量解析；写 ${error_page_404} 会被当作字面路径导致资源找不到，甚至引发默认错误页循环。
Tomcat 本身不支持通过环境变量直接控制 error-page 配置项——web.xml 中的 <error-code></error-code>、<location></location> 等必须是静态字符串，无法注入环境变量值。想“用环境变量配置错误页面路径”，得绕过 XML 声明，改用程序化注册方式。
为什么 web.xml 里不能写 ${ENV_VAR}？
Tomcat 的 web.xml 解析器不执行 EL 表达式或系统属性替换（类似 Spring 的 ${...}），它只做 XML 结构校验和字面量解析。你写 <location>/${ERROR_PAGE_404}</location> 会被当成字面路径，最终导致 404 页面找不到，甚至触发 Tomcat 默认错误页循环。
Spring Boot 应用中动态注册 error page
如果你用的是 Spring Boot（底层嵌入 Tomcat），可以用 ErrorPageRegistrar 或 ErrorPageRegistry 在运行时读取环境变量并注册：
- 在
@Configuration类中定义ErrorPageRegistrarBean - 从
System.getProperty("xxx")或System.getenv("XXX")读取路径 - 构造
ErrorPage对象，调用registry.addErrorPages(...)
示例代码片段：
@Bean
public ErrorPageRegistrar errorPageRegistrar() {
return registry -> {
String custom404 = System.getenv("TOMCAT_ERROR_404_PATH");
if (custom404 != null && !custom404.trim().isEmpty()) {
registry.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, custom404));
}
};
}
注意：该路径必须以 / 开头，且需确保对应资源在 classpath 或 webapp 根目录下可访问（如 /error/404-en.html）。
纯 Tomcat（非 Spring）如何间接支持？
标准 Tomcat 不提供环境变量绑定机制，但可通过以下两种方式变通：
-
启动脚本预处理：在
catalina.sh或setenv.sh中用 sed 替换web.xml模板里的占位符，生成最终配置文件 -
自定义 Valve：编写一个继承
ValveBase的类，在invoke()中拦截 404/500 响应，重定向到由System.getenv()决定的 URL（需部署为全局 Valve，修改conf/server.xml）
后者更灵活但侵入性强；前者简单可靠，适合 CI/CD 流水线中统一管理多环境错误页路径。
真正容易被忽略的一点是：无论哪种方式，<location></location> 指向的资源必须能被当前 WebApp 的 ServletContext 正确解析——路径不是相对当前 JSP，而是相对于应用上下文根（/），且不能跨域或跳转到外部 URL（Tomcat 会静默忽略非本地路径）。
