同版本Tomcat行为差异原因及应用Docker迁移技术咨询

先把你提供的原实例运行信息贴出来，方便对照分析：

Instance:
Using CATALINA_BASE: /services/app
Using CATALINA_HOME: /fr/third-party/tomcat-7.0.47
Using CATALINA_TMPDIR: /services/app/temp
Using JRE_HOME: /fr/third-party/jdk1.8.0_66/jre
Using CLASSPATH: /fr/third-party/tomcat-7.0.47/bin/bootstrap.jar:/services/app/bin/tomcat-juli.jar
Using CATALINA_PID: /services/app/bin/app.pid
Server version: Apache Tomcat/7.0.47
Server built: Oct 18 2013 01:07...

这是个非常典型的迁移坑，我帮你梳理下实际排查中高频遇到的几个原因：

1. CATALINA_BASE与CATALINA_HOME的路径映射没做好 #

你原部署用了Tomcat的「分离部署」模式——把核心程序（CATALINA_HOME）和实例配置/应用（CATALINA_BASE）分开，这是最佳实践，但Docker里很容易忽略这点：

• 如果你的Docker镜像只复制了/fr/third-party/tomcat-7.0.47（CATALINA_HOME），却没把原实例的/services/app（CATALINA_BASE）目录完整复制或挂载到容器里，那Docker里的Tomcat会默认用CATALINA_HOME作为CATALINA_BASE，相当于用了一个全新的Tomcat实例，配置、webapps、临时目录全不一样，运行行为肯定不一致。
• 检查Docker镜像里是否正确设置了CATALINA_BASE环境变量，并且对应的目录包含原实例的conf、webapps、temp、bin/tomcat-juli.jar这些关键内容。

2. JVM参数与运行环境不匹配 #

虽然JDK版本相同，但JVM的运行参数可能差很多：

• 原实例的启动脚本（比如catalina.sh或你们自定义的启动脚本）里大概率设置了JAVA_OPTS或CATALINA_OPTS（比如-Xmx2g、-XX:+UseG1GC这类内存、GC参数），如果Docker里的启动命令没继承这些参数，Tomcat的内存分配、垃圾回收行为会完全不同，可能出现内存溢出、响应慢等问题。
• 对比原实例的启动参数，把相同的参数加到Docker的启动命令里，比如在docker run时通过-e JAVA_OPTS="..."传递，或者在Dockerfile里设置环境变量。

3. 文件权限与运行用户不匹配 #

原Tomcat在宿主机用某个用户运行，而Docker容器默认可能用root或其他用户，这会导致权限问题：

• 比如Tomcat需要写入/services/app/logs或temp目录，如果容器里的用户没有读写权限，会出现日志无法生成、临时文件创建失败的情况，表现为应用报错或行为异常。
• 要么在Dockerfile里创建和原实例相同的用户，并用该用户启动Tomcat；要么确保CATALINA_BASE目录的权限设置正确（比如RUN chmod -R 755 /services/app）。

4. 类路径与依赖库缺失 #

原实例的CLASSPATH包含了/services/app/bin/tomcat-juli.jar，这是自定义的日志实现JAR，如果Docker里没把这个文件放到对应路径，或者CLASSPATH设置不对，会导致日志行为异常，甚至影响Tomcat启动：

• 除了这个JAR，原CATALINA_BASE的lib目录下可能还有你们自己添加的依赖JAR（比如数据库驱动、自定义工具类），这些都要复制到Docker镜像的对应位置，同时确保CLASSPATH环境变量和原实例一致。

5. 容器资源限制与系统环境差异 #

Docker容器是隔离环境，和宿主机的资源、内核参数可能不同：

• 比如宿主机给Tomcat分配了足够的内存和CPU，但Docker容器设置了--memory=1g或--cpus=1的限制，导致Tomcat运行时资源不足，表现为响应超时、请求排队等。
• 另外，宿主机可能调整了内核参数（比如ulimit -n设置了大的文件描述符限制），而Docker容器默认值较低，会导致Tomcat无法处理足够的并发连接。

6. 配置文件里的绝对路径问题 #

原配置文件（比如server.xml、context.xml）里可能包含宿主机的绝对路径（比如数据源配置里的文件路径、日志输出路径），这些路径在Docker容器里不存在，会导致功能失效：

• 检查所有配置文件里的路径，改成容器内的相对路径或者通过环境变量动态替换，比如把/var/log/tomcat改成${CATALINA_BASE}/logs。

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