一、环境配置错误
JAVA_HOME未正确设置
表现：启动Tomcat时日志报错“The JAVA_HOME environment variable is not defined”。
原因：未在系统环境变量或Tomcat配置中配置JDK安装路径。
解决：编辑/etc/profile文件，添加export JAVA_HOME=/usr/local/java（替换为实际JDK路径），并执行source /etc/profile使配置生效。
JDK与Tomcat版本不兼容
表现：启动时报UnsupportedClassVersionError或类加载错误（如Tomcat 10需JDK 11+，Tomcat 9需JDK 8+）。
原因：Tomcat版本与JDK版本未匹配官方兼容性要求。
解决：参考Tomcat官方文档调整JDK版本（如Tomcat 10对应JDK 11及以上），确保两者版本兼容。
二、权限与端口问题
文件/目录权限不足
表现：Tomcat无法写入日志（logs目录）、解压WAR包（webapps目录）或启动，报错“Permission denied”。
原因：Tomcat运行用户（如tomcat）对关键目录无读写执行权限。
解决：执行chmod -R 755 /usr/local/tomcat赋予读写执行权限，chown -R tomcat:tomcat /usr/local/tomcat设置属主为Tomcat用户。
端口冲突
表现：启动时报“Address already in use”（端口已被占用），无法绑定8080等默认端口。
原因：旧Tomcat进程未关闭，或其他服务（如Nginx、Apache）占用了Tomcat端口。
解决：执行netstat -tuln | grep 8080查看端口占用进程，用kill -9 <PID>结束占用进程；或修改conf/server.xml中的<Connector port="8080">为未被占用的端口（如8081）。
三、项目部署问题
WAR包无法自动解压
表现：将WAR包放入webapps目录后，未生成对应项目目录，访问时报404错误。
原因：WAR包损坏（如下载不完整），或Tomcat未开启自动部署（conf/server.xml中autoDeploy="false"）。
解决：用jar -xvf project.war命令手动解压WAR包，检查文件完整性；确保server.xml中<Host>标签的autoDeploy属性为true。
数据库连接失败
表现：应用日志报Connection refused、SQLException（如“Cannot create PoolableConnectionFactory”）。
原因：数据库服务未启动（如MySQL未运行），或连接参数（URL、用户名、密码）配置错误（WEB-INF/web.xml或连接池配置文件）。
解决：执行systemctl start mysql启动数据库服务；检查连接配置中的URL（如jdbc:mysql://localhost:3306/dbname）、用户名、密码是否正确。
四、内存与资源问题
内存溢出（OOM）
表现：日志报java.lang.OutOfMemoryError: Java heap space（堆内存不足）、PermGen space（永久代空间不足，Java 8前）或Metaspace（Java 8及以后）。
原因：默认内存分配过小（如初始堆内存128MB），或应用存在内存泄漏（如循环中创建大量对象）。
解决：调整bin/catalina.sh中的JVM参数（以堆内存为例）：JAVA_OPTS="-Xms512m -Xmx1024m"（初始512MB，最大1024MB）；若为PermGen space错误，添加-XX:PermSize=128m -XX:MaxPermSize=256m（Java 8前）；若为Metaspace错误，添加-XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=256m（Java 8及以后）。
线程耗尽
表现：Tomcat停止响应，日志报java.lang.OutOfMemoryError: unable to create new native thread。
原因：高并发请求下，线程池中的线程数量达到上限（默认200），无法创建新线程。
解决：修改conf/server.xml中的<Connector>标签，增加maxThreads（最大线程数，如500）和acceptCount（等待队列长度，如200）参数：<Connector port="8080" protocol="HTTP/1.1" maxThreads="500" acceptCount="200" ... />。
文件句柄耗尽
表现：日志报Too many open files（打开文件数超过系统限制），Tomcat无法创建新连接（如数据库连接、文件读取）。
原因：系统默认文件句柄限制过低（如1024），应用未及时关闭文件、socket等资源。
解决：执行ulimit -n 65535临时增加当前用户的文件句柄限制；编辑/etc/security/limits.conf，添加tomcat hard nofile 65535和tomcat soft nofile 65535（永久生效）；优化应用代码，确保及时关闭资源（如Socket.close()、InputStream.close()）。
五、日志与调试技巧
查看实时日志
表现：需要监控Tomcat启动或运行时的实时日志，定位错误原因。
解决：执行tail -f /usr/local/tomcat/logs/catalina.out（Tomcat默认日志路径），实时查看日志输出。
403访问被拒绝
表现：访问Tomcat管理页面（如http://localhost:8080/manager/html）时，提示“403 Access Denied”（权限不足）。
原因：tomcat-users.xml未配置管理员角色和用户，或manager应用的context.xml限制了IP访问。
解决：修改conf/tomcat-users.xml，添加管理员角色和用户：<role rolename="manager-gui"/><user username="admin" password="123456" roles="manager-gui"/>；修改webapps/manager/META-INF/context.xml，注释或删除<Valve>标签中的IP限制（如<Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127\.0\.0\.1" />）。
中文乱码
表现：Tomcat日志或应用输出中文时显示为乱码（如“???”）。
原因：系统或Tomcat配置的字符集不匹配（如系统为UTF-8，Tomcat为ISO-8859-1）。
解决：修改conf/logging.properties，将java.util.logging.ConsoleHandler.encoding设置为GBK（如java.util.logging.ConsoleHandler.encoding = GBK）；或在启动脚本catalina.sh中添加-Dfile.encoding=GBK参数。
六、其他高频问题
SELinux限制
表现：Tomcat无法访问某些文件或端口（如logs目录无法写入），即使权限正确。
原因：SELinux（安全增强型Linux）开启了强制访问控制（MAC），限制了Tomcat的权限。
解决：临时关闭SELinux（不推荐生产环境）：setenforce 0；或配置SELinux策略（推荐）：chcon -R -t httpd_sys_rw_content_t /usr/local/tomcat/logs（允许Tomcat读写logs目录）。
无法关闭Tomcat
表现：执行./shutdown.sh后，Tomcat进程未关闭，仍占用端口。
原因：shutdown.sh无法连接到Tomcat的关闭端口（默认8005），或端口被防火墙阻止。
解决：检查conf/server.xml中的<Server port="8005">配置，确保端口未被占用；执行netstat -tuln | grep 8005查看端口状态，若有占用则结束对应进程；若防火墙阻止，执行sudo ufw allow 8005（Ubuntu）或firewall-cmd --add-port=8005/tcp --permanent（CentOS）开放端口。