setenv.sh/bat 不能设置 HTTP 响应头，仅用于传递 JVM 参数（如 -Dapp.env=prod）；响应头必须通过 Filter 或 Servlet 代码调用 response.setHeader() 注入，且应使用 System.getProperty() 读取启动时注入的属性。
setenv.sh 和 setenv.bat 是 Tomcat 启动时自动加载的环境配置入口，但它们不参与 HTTP 响应头生成——响应头由 Servlet 容器（Catalina）和应用代码控制，不是靠环境变量直接注入的。想在响应中加自定义头（如 X-Env、X-Deploy-Id），必须走标准 Web 层机制，而非改 setenv。
setenv.sh / setenv.bat 不能设置响应头，只能传给 JVM 或启动脚本
setenv 文件的作用是为 catalina.sh / catalina.bat 提供额外的 shell 变量或 JVM 参数，比如：
-
JAVA_HOME或JRE_HOME（Linux 下优先用JRE_HOME） -
JAVA_OPTS（影响 JVM 启动参数，如堆内存、GC 日志） -
CATALINA_OPTS（只用于 Tomcat 本身，不影响子进程） -
CLASSPATH（极少用，一般不建议手动改）
这些变量不会自动变成 HTTP 响应头。如果你在 setenv.sh 里写 MY_HEADER="prod-v2"，它对任何 HTTP 请求/响应完全无感知。
常见错误现象：
- 在
setenv.sh中定义了APP_VERSION=1.2.3，然后期待浏览器响应里出现X-App-Version: 1.2.3→ 实际不会出现 - 修改后重启 Tomcat，用
curl -I <a href="https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e">https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e</a>检查响应头，发现新增头根本没生效
正确做法：用 Filter 或 ServletContextListener 注入响应头
要让所有响应带上自定义头，最稳妥的方式是写一个全局 Filter，在 doFilter 中调用 response.setHeader()：
public class HeaderInjectFilter implements Filter {
private String envName;
@Override
public void init(FilterConfig config) {
// 从系统属性读取，需确保启动时已设好
this.envName = System.getProperty("app.env", "unknown");
}
@Override
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
throws IOException, ServletException {
HttpServletResponse response = (HttpServletResponse) res;
response.setHeader("X-Env", envName);
response.setHeader("X-Server-Time", Instant.now().toString());
chain.doFilter(req, res);
}
}然后在 web.xml 中注册（或用 @WebFilter 注解）：
<filter>
<filter-name>HeaderInjectFilter</filter-name>
<filter-class>com.example.HeaderInjectFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>HeaderInjectFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>启动前，通过 setenv.sh 把值传进 JVM：
# bin/setenv.sh JAVA_OPTS="$JAVA_OPTS -Dapp.env=staging -Ddeploy.id=$(date +%s)"
这样 System.getProperty("app.env") 才能拿到值 —— setenv 只是“搬运工”，不是“注入点”。
为什么不用 response.addHeader() 直接硬编码？容易踩的坑
- 硬编码（如写死
"X-Env: prod"）导致每次发版都要改代码、重新编译，违背配置外置原则 - 多环境（dev/staging/prod）共用同一份 WAR 包时，无法动态区分
- 若依赖
System.getenv()（读操作系统环境变量），在 Windows 上可能因大小写敏感或权限被截断（如服务方式运行时） -
System.getProperty()是唯一被 Tomcat 启动脚本明确支持且稳定传递的途径；System.getenv()不保证在所有容器模式下可用
所以务必：
- 用
-Dkey=value方式通过JAVA_OPTS注入 JVM 属性 - 在 Java 代码中用
System.getProperty("key")读取 - 避免在 Filter 中调用
System.getenv("KEY")
Tomcat 的 setenv 文件只负责启动期变量传递，它离 HTTP 响应头中间隔着 Catalina 引擎、Servlet 规范、类加载器和你的业务代码。真正起作用的是你写的那几行 response.setHeader()，而它的输入来源，得靠 setenv + -D 这种组合来打通。漏掉任意一环，头就出不来。
