怎样调试debian tomcat

在 Debian 上调试 Tomcat，一般可以从日志、配置、进程、端口、远程调试几个方面入手。下面按常见场景给你一个实用清单。

一、基础环境确认

1. 确认 Tomcat 是否安装及版本

dpkg -l | grep tomcat
# 或
ls /usr/share/tomcat*/

Debian 常见包：

tomcat9
tomcat10

2. 查看 Tomcat 状态

systemctl status tomcat9

启动 / 停止 / 重启：

sudo systemctl start tomcat9
sudo systemctl stop tomcat9
sudo systemctl restart tomcat9

二、日志调试（最重要）

1. 主要日志位置

/var/log/tomcat9/

常见文件：

catalina.out：最重要的运行日志
catalina.yyyy-mm-dd.log
localhost.yyyy-mm-dd.log

实时查看：

tail -f /var/log/tomcat9/catalina.out

三、端口与进程问题

1. 查看 Tomcat 是否在监听

ss -lntp | grep java
# 或
netstat -lntp | grep 8080

默认端口：

HTTP：8080
AJP：8009（新版本默认关闭）

2. 端口被占用

修改端口：

/etc/tomcat9/server.xml

<Connector port="8080" ... />

四、配置调试

1. server.xml（核心配置）

/etc/tomcat9/server.xml

常见问题：

应用路径错误
Context 配置错误
端口冲突

2. web.xml

/etc/tomcat9/web.xml

五、应用部署调试

部署目录

/var/lib/tomcat9/webapps/

常见问题：

WAR 包未解压
应用抛异常
缺少依赖（如 JDBC 驱动）

查看应用日志：

/var/log/tomcat9/localhost.*.log

六、权限问题（Debian 特有）

Debian 下 Tomcat 通常以 tomcat 用户运行：

ps aux | grep tomcat

常见错误：

修复示例：

sudo chown -R tomcat:tomcat /var/lib/tomcat9/webapps
sudo chmod 755 /var/lib/tomcat9/webapps

七、远程调试（IDE 调试）

1. 开启 JPDA 远程调试

编辑：

/etc/default/tomcat9

添加或修改：

JAVA_OPTS="-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n"

重启：

sudo systemctl restart tomcat9

IDE（IntelliJ / Eclipse）连接：

Host: localhost
Port: 8000

八、常见错误速查

现象	可能原因
启动失败	server.xml 配置错误
页面 404	应用未部署或路径错误
权限拒绝	tomcat 用户无权限
端口占用	已有 Tomcat 在运行
中文乱码	文件/日志编码问题

九、快速排查流程（推荐）

systemctl status tomcat9
tail -f /var/log/tomcat9/catalina.out
ss -lntp | grep 8080
ls /var/lib/tomcat9/webapps

如果你愿意，可以告诉我：

Debian 版本（11 / 12）
Tomcat 版本
具体报错信息或现象

我可以帮你精确定位问题。