在阿里云服务器上部署 Java Web 项目,执行 Tomcat 启动脚本只是开始。服务可能已经运行,但浏览器仍然打不开;也可能启动后很快退出。Java 版本、端口占用、目录权限、Tomcat 配置和安全组规则,都可能是问题所在。排查时先确认服务有没有在服务器本机正常响应,再检查外部网络,能少走不少弯路。
启动前先检查服务器环境
以下命令以常见 Linux 服务器为例。不同发行版的安装方式、默认目录和服务管理工具可能不一样,操作前先确认系统信息:
- 确认操作系统:执行
cat /etc/os-release查看发行版,别把适用于一种系统的安装命令直接套到另一种系统上。 - 检查 Java:执行
java -version。如果提示找不到命令,可能是尚未安装 JDK,也可能是环境变量没有配置好。 - 核对版本兼容性:按项目要求选择 Tomcat 版本,并确认它支持当前 Java 版本。项目依赖旧版 Java 时,直接升级运行环境可能导致应用无法启动。
- 查看端口状态:Tomcat 默认使用 8080 端口。若端口已被其他进程占用,应先确认进程用途,再决定释放端口还是调整 Tomcat 配置。
生产环境建议使用项目明确支持的 Java 版本,同时确认操作系统架构与安装包相符。安装后再执行一次 java -version,检查当前实际生效的版本。只看到安装包或安装目录,并不能说明 Java 已经可供 Tomcat 使用。
安装并启动 Tomcat
使用系统软件仓库安装时,先看仓库提供的 Tomcat 版本是否符合项目要求。如果需要指定版本,可以从官方渠道获取压缩包,解压到固定目录,例如 /opt/tomcat。正式运行时,建议创建专用普通用户来管理 Tomcat,不要长期以 root 身份启动服务。
进入 Tomcat 的 bin 目录后,运行启动脚本:
cd /opt/tomcat/bin./startup.sh
终端显示启动完成,只能说明脚本执行过,不能据此判断应用已正常提供服务。可以接着检查进程、端口和日志:
- 执行
ps -ef | grep tomcat,查看 Tomcat 相关进程是否存在; - 执行
ss -lntp | grep 8080,确认 8080 端口是否处于监听状态; - 查看
/opt/tomcat/logs/catalina.out和当天的 Tomcat 日志,留意启动异常及应用部署报错。
临时测试时,启动脚本足以验证环境。需要长期运行的服务,建议配置 systemd 管理,这样可以统一查看状态、启动服务并设置开机启动。
使用 systemd 管理服务
可以创建 /etc/systemd/system/tomcat.service,再按服务器上的实际目录、Java 路径和运行用户修改配置。以下是简化示例:
[Unit]
Description=Apache Tomcat
After=network.target
[Service]
Type=forking
Environment=JAVA_HOME=/usr/lib/jvm/java-17-openjdk
Environment=CATALINA_HOME=/opt/tomcat
Environment=CATALINA_BASE=/opt/tomcat
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
User=tomcat
Group=tomcat
[Install]
WantedBy=multi-user.target
保存后运行 systemctl daemon-reload,再执行 systemctl start tomcat 启动服务。确认服务正常后,用 systemctl enable tomcat 设置开机启动。日常查看状态可运行 systemctl status tomcat,查看服务日志可运行 journalctl -u tomcat -e。
示例中的 JAVA_HOME、Tomcat 目录和 tomcat 用户都要替换为服务器上的真实配置。systemd 不一定能读取登录终端里的环境变量;如果服务文件中的 Java 路径错误,可能出现终端里能运行 Java、服务却启动失败的情况。
阿里云上还要检查网络放行
服务器内的 Tomcat 正在监听 8080,不等于公网已经可以访问。先检查阿里云实例绑定的安全组入方向规则,确认目标端口允许相应来源访问;如果操作系统启用了防火墙,也要核对本机规则是否放行。
可以先在服务器上执行 curl -I http://127.0.0.1:8080。如果本机有响应,外网却连接超时,Tomcat 通常不是第一排查对象,应继续检查安全组、本机防火墙、实例公网地址和访问路径。生产环境不要长期把 8080 对所有来源开放,可以通过 Nginx 反向代理提供 80 或 443 端口,并限制管理端口的访问范围。
案例:服务已启动,浏览器仍打不开
某团队把应用部署到阿里云 Linux 实例,执行 startup.sh 后看到启动提示,但浏览器访问公网地址的 8080 端口一直超时。运维人员先在服务器本机执行 curl,确认 Tomcat 能返回响应;再用 ss 检查,发现 8080 确实处于监听状态。
这两项结果说明 Java 和 Tomcat 基本正常,接下来应检查网络规则。团队发现实例安全组只放行了 SSH 端口,没有允许访问 8080。为测试人员的来源地址添加入方向规则后,页面恢复访问。上线前,他们又改用 Nginx 提供 HTTPS 入口,并收紧安全组规则,避免 Tomcat 管理端口长期暴露在公网。
常见启动失败原因与处理方式
- 提示 Java 不存在:确认 JDK 已安装,并检查 systemd 文件里的
JAVA_HOME是否指向真实目录。终端能执行 Java,不代表 systemd 使用了相同的环境变量。 - 端口被占用:用
ss -lntp查找占用端口的进程。确认进程用途后再处理;不清楚用途时,不要直接结束进程,可以考虑调整 Tomcat 的 Connector 端口。 - 启动后立即退出:结合
systemctl status tomcat、journalctl -u tomcat -e和 Tomcat 日志检查配置格式、目录权限、内存参数及应用部署错误。 - 首页能打开,应用却报错:Tomcat 进程可能已经正常运行,故障更可能出在应用包、数据库连接、配置文件或依赖服务,继续查看应用日志更有帮助。
- 修改端口后仍无法访问:检查 Tomcat Connector 配置是否已修改并重启服务,同时确认安全组和本机防火墙放行的是新端口,而不是仍按 8080 配置。
部署完成后的检查清单
阿里云 Tomcat 启动后,逐项确认 Java 版本与项目兼容、服务进程稳定、目标端口正在监听,应用日志没有持续报错。访问测试分两步做:先在服务器本机请求,再从外部网络访问。这样可以区分服务端故障与网络访问问题。
长期运行前,还应配置开机启动、日志轮转、备份和监控。若服务对公网开放,启用 HTTPS,关闭不需要的端口,并避免使用默认管理账号或弱口令。遇到启动问题时,先看进程和监听端口,再沿着 Java 环境、Tomcat 配置、应用日志、安全组和防火墙逐项排查,不必反复执行启动脚本碰运气。