Jenkins部署项目后$CATALINA_BASE下项目XML文件丢失，求自动生成方案

结合我在Tomcat和Jenkins部署中的实际踩坑经验，来帮你梳理并解决这个问题：

一、$CATALINA_BASE/conf/Catalina/localhost/{projectname}.xml是否为部署过程自动生成？ #

这个文件是Tomcat的项目上下文配置文件，它的生成分两种情况：

• 如果你的war包中自带META-INF/context.xml，且通过Jenkins的Tomcat插件正常部署，Tomcat会在部署时自动将这个文件复制到上述路径，属于部署流程自动生成的文件。
• 但如果是你手动创建这个文件来配置数据库连接等参数，Jenkins默认的部署流程（比如勾选了「重新部署前先卸载应用」）可能会将其删除——因为Tomcat在卸载应用时，会自动清理对应的上下文配置文件。

另外，如果部署后这个文件没生成，大概率是war包里没有自带context.xml，或者Jenkins部署配置的清理逻辑过度，导致刚生成的文件又被删掉了。

二、如何配置让该文件自动生成/保留？ #

根据不同的部署场景，分享几种可行的配置方式：

1. 让war包自带context.xml，部署时自动生成 #

这是最标准的做法，也能适配多环境部署：

• 在你的Java Web项目中，创建src/main/webapp/META-INF/context.xml，把数据库连接池等配置写在里面，示例代码：

<?xml version="1.0" encoding="UTF-8"?>
<Context>
    <Resource name="jdbc/YourDB" auth="Container" type="javax.sql.DataSource"
              maxTotal="100" maxIdle="30" maxWaitMillis="10000"
              username="your_db_user" password="your_db_pass" 
              driverClassName="com.mysql.cj.jdbc.Driver"
              url="jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC"/>
</Context>

• 打包war包时确保这个文件被包含进去，然后通过Jenkins部署war包到Tomcat。Tomcat会自动将war包里的context.xml复制到目标路径，即使重新部署也会自动生成新的配置文件。

2. 手动维护配置文件，让Jenkins部署时同步 #

如果你的上下文配置不想放在war包里（比如不同环境有不同的数据库账号密码），可以这样做：

• 把{projectname}.xml放到你的项目源码仓库的配置目录中（比如单独的config/tomcat文件夹）。
• 在Jenkins的部署流程中，添加一个复制文件的步骤：可以用shell执行cp命令，或者用Jenkins的Copy Artifacts插件，在部署war包之后，将仓库中的配置文件复制到$CATALINA_BASE/conf/Catalina/localhost/目录下。
• 注意要给Jenkins执行用户配置该目录的读写权限，避免复制失败。

3. 全局配置Tomcat，避免上下文文件被删除 #

如果不想依赖war包或Jenkins的复制步骤，可以直接在Tomcat的全局配置中固定项目上下文：

• 编辑$CATALINA_BASE/conf/server.xml，找到<Host>节点，添加你的项目上下文配置：

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
    <!-- 其他原有配置 -->
    <Context path="/{projectname}" docBase="/home/www/webapps/{projectname}" 
             reloadable="true">
        <!-- 数据库连接池配置 -->
        <Resource name="jdbc/YourDB" auth="Container" type="javax.sql.DataSource"
                  maxTotal="100" maxIdle="30" maxWaitMillis="10000"
                  username="your_db_user" password="your_db_pass" 
                  driverClassName="com.mysql.cj.jdbc.Driver"
                  url="jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC"/>
    </Context>
</Host>

• 这种方式下，Tomcat启动时会自动加载这个配置，Jenkins部署时不会删除server.xml里的内容，但修改配置后需要重启Tomcat才能生效，灵活性稍差。

额外注意点 #

• 检查Jenkins部署配置中是否勾选了「Delete old work directory」或类似清理选项，这类选项可能会误删上下文文件，建议取消勾选。
• 确保Jenkins执行用户对$CATALINA_BASE/conf/Catalina/localhost/目录有读写权限，否则无法生成或复制配置文件。

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