如何解决Ubuntu Tomcat连接问题

Ubuntu Tomcat连接问题排查与修复

一、快速定位流程

• 确认服务状态与端口监听：查看进程与端口，确认 Tomcat 是否在预期端口（默认 8080）监听。示例：ps -ef | grep tomcat、sudo ss -tulpen | grep 8080 或 sudo lsof -i :8080。若端口未监听，多半是未启动或启动失败。
• 本机直连验证：在服务器本机执行 curl -I http://localhost:8080，能返回 HTTP/1.1 200 说明 Tomcat 与应用基本可用。
• 跨机连通性验证：从客户端执行 ping <服务器IP> 与 nc -vz <服务器IP> 8080 或 curl -I http://<服务器IP>:8080，判断网络与端口可达性。
• 防火墙与安全组：在 Ubuntu 检查 sudo ufw status，必要时放行端口（如 sudo ufw allow 8080/tcp）；云服务器还需在控制台安全组放行对应端口。
• 查看日志定位根因：tail -f $CATALINA_HOME/logs/catalina.out、tail -f $CATALINA_HOME/logs/localhost*.log，关注启动报错、部署失败、连接池耗尽等关键字。

二、常见错误与对应修复

• 出现 “Connection refused”
  含义：目标主机端口未监听或拒绝连接。排查顺序：服务是否启动 → 端口是否被占用 → 防火墙/安全组是否放行 → 配置端口是否正确。处理要点：启动服务；若端口冲突，结束占用进程或修改 server.xml 的 Connector 端口；放行防火墙端口；核对 server.xml 中端口配置。
• 端口被占用（Bind failed）
  现象：启动时报 “Address already in use / Bind failed”。处理：用 ss -tulpen | grep 8080 或 lsof -i :8080 找到 PID，评估后 kill <PID>；或调整 server.xml 的 <Connector port="8080"> 为未占用端口并重启。
• 虚拟机或云主机能本机访问，外部访问不通
  高概率是防火墙/安全组未放行、或虚拟网络模式导致主机与虚机不通。处理：在 Ubuntu 执行 sudo ufw allow 8080/tcp；云主机在控制台安全组放行 8080/TCP；检查虚拟机网络（桥接/NAT）与端口转发规则是否正确。
• 访问慢或偶发超时
  优化连接器与线程：connectionTimeout="20000"、maxThreads="200"、acceptCount="100"；必要时调整 JVM：-Xms512m -Xmx2048m -XX:MaxMetaspaceSize=512m -XX:+UseG1GC；检查数据库/外部依赖连接池与超时配置。
• 使用 80 端口失败或权限不足
  原因：Linux 只有 root 可监听 1024 以下端口。方案：改用 8080/8081 等高端口；或以 root 运行（不推荐）；或通过反向代理（Nginx/Apache）监听 80/443 并转发到 8080。

三、配置与网络关键点

• 核对监听端口：编辑 conf/server.xml 的 <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />，确保端口未被占用且重启后生效。
• 防火墙放行：Ubuntu 常用 sudo ufw allow 8080/tcp；如使用云服务器，同步在云平台安全组放行对应端口。
• 监听地址绑定：如需仅本机访问，可将 server.xml 的 Connector 添加 address="127.0.0.1"；如需所有地址访问，确保未绑定到 127.0.0.1。
• 反向代理示例（Nginx，端口 80 → 8080）：

  upstream tomcat {
      server 127.0.0.1:8080;
  }
  server {
      listen 80;
      location / {
          proxy_pass http://tomcat;
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_set_header X-Forwarded-Proto $scheme;
      }
  }
  

四、apt 安装与手动安装的要点

• 使用 apt 安装（如 tomcat9）：服务管理用 sudo systemctl status|start|restart tomcat9；配置在 /etc/tomcat9/（如 server.xml、tomcat-users.xml、/etc/default/tomcat9）；日志在 /var/log/tomcat9/；默认端口 8080。
• 手动安装：配置与日志通常在 $CATALINA_HOME/conf/ 与 $CATALINA_HOME/logs/；启动用 bin/startup.sh，停止用 bin/shutdown.sh；同样通过 server.xml 调整端口与连接器参数。

五、一键排查清单

以上步骤覆盖了 服务状态、端口监听、连通性、防火墙/安全组、配置与日志 五大维度，可系统化解决绝大多数 Ubuntu 上的 Tomcat 连接问题。