Tomcat中如何将setenv.sh的变量值引入server.xml？其在context.xml生效但server.xml不生效

Tomcat默认对不同配置文件的变量解析规则不同，context.xml默认支持读取系统属性/环境变量，server.xml默认仅启用有限的变量源，需要额外配置才能正常读取setenv.sh中定义的变量，具体操作如下：

步骤1：确认setenv.sh中变量的导出格式 #

setenv.sh中的变量需要导出为JVM系统属性，才能被Tomcat的配置解析器识别：

错误写法（仅为shell本地变量，Tomcat进程无法读取）
MY_SERVICE_PORT=8088
正确写法（注入到JVM启动参数中）
export CATALINA_OPTS="$CATALINA_OPTS -Dservice.port=8088 -Dservice.host=0.0.0.0"
变量名建议用小写加.分隔的格式，避免和系统内置环境变量冲突。

步骤2：开启server.xml的变量替换功能 #

进入Tomcat安装目录的conf文件夹，打开catalina.properties文件，检查以下配置项：

org.apache.tomcat.util.digester.REPLACE_SYSTEM_PROPERTIES=true

如果该配置值为false或者不存在，修改/添加为true后保存。
如果需要直接读取shell环境变量而非JVM系统属性，还需要额外添加配置：

org.apache.tomcat.util.digester.ALLOW_ENVIRONMENT_VARIABLES=true

步骤3：在server.xml中引用变量 #

如果使用的是JVM系统属性，直接用${变量名}格式引用即可，示例如下：

<Connector port="${service.port}" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

如果使用的是shell环境变量，需要添加env.前缀，示例：

<Connector port="${env.MY_SERVICE_PORT}" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

异常排查 #

• 配置修改后必须完全重启Tomcat进程才能生效，配置热重载不支持变量更新
• 启动后执行ps -ef | grep tomcat查看进程启动参数，确认-Dservice.port=xxx等自定义参数已经正确注入到进程中
• 变量名严格区分大小写，注意和setenv.sh中定义的名称保持完全一致

内容的提问来源于stack exchange，提问作者user9616338