本文详解 ubuntu 22.04 下 tomcat 8.5 使用 systemctl 启动后无法响应 http 请求（如 localhost:8080）的根本原因，重点解决因环境变量、用户权限、forking 模式配置不当导致的静默启动失败问题，并提供可直接复用的 systemd 单元文件与验证步骤。

本文详解 ubuntu 22.04 下 tomcat 8.5 使用 systemctl 启动后无法响应 http 请求（如 localhost:8080）的根本原因，重点解决因环境变量、用户权限、forking 模式配置不当导致的静默启动失败问题，并提供可直接复用的 systemd 单元文件与验证步骤。

在 Ubuntu 22.04 上以 systemd 管理 Tomcat 8.5 时，常见现象是：systemctl start tomcat 显示“active (running)”，但 curl http://localhost:8080 超时或拒绝连接；而手动执行 /opt/tomcat/bin/startup.sh 却完全正常——这并非端口冲突或防火墙问题，而是 systemd 服务配置未正确适配 Tomcat 的启动生命周期所致。

核心问题在于 Type=forking 模式下，systemd 无法准确追踪 Tomcat 主进程。Tomcat 的 startup.sh 实际是通过 fork 启动后台 Java 进程并立即退出 shell 脚本，若未正确设置 PIDFile= 或 SuccessExitStatus=，systemd 会误判启动失败（如 journalctl -u tomcat 中显示 exit status 1 和 failed with result 'exit-code'），即使后续 Java 进程仍在运行，systemd 也会标记为 failed，进而影响依赖关系、自动重启及日志聚合——这也解释了为何 Catalina 日志中缺失 Spring Security 初始化日志：进程虽存活，但 systemd 已放弃管理，部分环境上下文（如完整环境变量继承）可能未被正确注入。

✅ 正确解决方案需同步满足以下四点：

Yuanfang Design System

yuanfang-skills 的共享设计系统，提供 token CSS 变量、12+ 主题以及可复用的布局类型 HTML 块，供 yuanfang-html-image（以及 fu...）使用。

下载

1. 严格限定运行用户与权限
   Tomcat 必须由专用低权限用户（如 tomcat）运行，且其家目录、CATALINA_HOME 和 CATALINA_BASE 所有路径均需属主属组为该用户：

   sudo useradd -r -s /bin/false -d /opt/tomcat tomcat
   sudo chown -R tomcat:tomcat /opt/tomcat/
   sudo chmod -R u+x /opt/tomcat/bin/

2. 使用系统级 JDK 路径，避免 SDKMAN 干扰
   systemd 服务默认不加载用户 Shell 配置（如 .bashrc），因此 ~/.sdkman/candidates/java/... 路径不可见。应改用系统安装的 OpenJDK（推荐 java-11-openjdk-amd64 或 java-17-openjdk-amd64）：

   Environment="JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64"

3. 精简并加固 systemd 单元文件
   以下是经生产验证的 /etc/systemd/system/tomcat.service 配置（关键修正已加注）：

   [Unit]
   Description=Apache Tomcat Web Application Container
   After=network.target
   
   [Service]
   Type=forking
   User=tomcat
   Group=tomcat
   
   # ✅ 强制指定系统 JDK，避免路径解析失败
   Environment="JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64"
   Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom -Djava.awt.headless=true"
   Environment="CATALINA_BASE=/opt/tomcat"
   Environment="CATALINA_HOME=/opt/tomcat"
   Environment="CATALINA_PID=/opt/tomcat/temp/tomcat.pid"
   Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC"
   
   # ✅ 确保 PID 文件路径存在且可写（Tomcat 自动创建，但目录需存在）
   ExecStartPre=/bin/sh -c 'mkdir -p /opt/tomcat/temp'
   ExecStart=/opt/tomcat/bin/startup.sh
   ExecStop=/opt/tomcat/bin/shutdown.sh
   
   # ✅ 关键：启用自动恢复，避免单次失败后服务停滞
   RestartSec=10
   Restart=always
   
   # ✅ 显式声明成功退出码（startup.sh 成功时返回 0）
   SuccessExitStatus=0
   
   [Install]
   WantedBy=multi-user.target

4. 强制重载并深度验证
   修改后务必执行完整流程：

   sudo systemctl daemon-reload
   sudo systemctl stop tomcat
   sudo rm -f /opt/tomcat/temp/tomcat.pid  # 清理残留 PID
   sudo systemctl start tomcat
   # 实时跟踪启动过程
   sudo journalctl -u tomcat -f --since "1 minute ago"

   ✅ 正常输出应包含：Started Apache Tomcat Web Application Container + Tomcat started.，且 curl -I http://localhost:8080 返回 HTTP/1.1 200。

⚠️ 注意事项：

• 若应用 WAR 包含 Spring Boot 或复杂安全框架（如 Spring Security），请确保 CATALINA_OPTS 中未意外覆盖 JAVA_OPTS 的 -Djava.security.egd 参数（file:/dev/./urandom 中的 ./ 写法在 systemd 环境下可能失效，应统一为 file:///dev/urandom）；
• 禁用 startup.sh 中的 echo 或 set -x 调试语句，避免干扰 systemd 进程状态判断；
• 生产环境建议改用 Type=notify + tomcat-native 配合 systemd-notify，但需重新编译 Tomcat，本文方案兼容性最佳。

通过以上配置，systemd 将准确识别 Tomcat 主进程生命周期，确保环境变量完整注入、日志集中收集、故障自动恢复，彻底解决“看似运行实则不可用”的顽疾。