Spring Boot 部署到华为云 ECS 后无法访问?分享几个实用的排查思路
最近在整理 Java 项目的服务器部署流程,发现一个比较常见的问题:Spring Boot 应用在本地运行正常,部署到云服务器以后,日志也显示启动成功,但是浏览器通过公网 IP 就是访问不了。
这种问题其实挺容易让人走弯路的。刚开始可能会怀疑是 Java 环境、项目配置或者服务器本身的问题,但实际排查时,网络链路上的任何一个环节都可能导致访问失败。
这里结合 Spring Boot、Linux、Nginx 和华为云 ECS 的常见部署方式,整理一套比较实用的排查思路。
一、先确认应用是不是真的启动成功
很多时候看到控制台输出 Started Application,就认为服务已经完全正常了。
但应用成功启动,不代表对外提供服务的链路已经打通。
首先检查 Java 进程:
ps -ef | grep java
然后查看端口监听情况:
ss -lntp | grep 8080
假设 Spring Boot 配置的端口是 8080,我们还可以在服务器本机执行:
curl -i http://127.0.0.1:8080/
这里有个细节:如果项目没有配置根路径接口,返回 404 不一定说明服务异常。只要能得到应用返回的 HTTP 响应,就说明请求至少已经到达对应的 Web 服务。
如果这里就连接失败,优先检查应用日志、端口配置以及进程状态,不要急着去修改云服务器网络规则。
二、检查华为云 ECS 安全组
如果服务器本地可以访问,但外部访问失败,下一步就该检查安全组了。
华为云 ECS 的安全组相当于云服务器网络访问的第一层控制。
可以进入华为云控制台,找到对应 ECS 实例关联的安全组,查看入方向规则。
常见端口包括:
-
22:SSH 远程连接
-
80:HTTP 服务
-
443:HTTPS 服务
-
8080:一些 Java Web 项目常用的应用端口
假设使用 Nginx 对外提供 HTTP 服务,通常只需要为 Web 访问开放 80 和 443 端口,不建议把 Spring Boot 的 8080 端口直接暴露到公网。
另外,SSH 的 22 端口最好限制允许访问的来源 IP,而不是长期对所有地址开放。
还需要注意:配置了安全组规则,不代表操作系统内的防火墙也一定允许访问。
三、检查 Linux 防火墙
以 Ubuntu 为例,可以执行:
sudo ufw status
查看防火墙状态和已配置的规则。
如果服务器采用 Nginx 提供 HTTP/HTTPS 服务,需要保证对应端口可以正常接收请求。
例如:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
这里不建议为了排查问题直接关闭整个防火墙。
更合理的做法是明确哪些端口需要对外开放,只放行必要的流量。
如果使用的是其他 Linux 发行版,也要根据实际环境检查 firewalld、nftables 或其他防火墙规则。
四、使用 Nginx 做反向代理
对于 Spring Boot 项目,我更倾向于使用 Nginx 作为统一的 HTTP 入口,而不是让 Java 服务直接暴露到公网。
一个简单的 Nginx 配置如下:
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://127.0.0.1:8080;
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;
}
}
这里的 example.com 需要替换成实际域名,并确保域名已经正确解析。
如果 Nginx 和 Spring Boot 部署在同一台服务器上,可以让 Spring Boot 只监听本地回环地址,再由 Nginx 负责对外提供服务。
修改配置后先检查语法:
sudo nginx -t
确认没有错误,再重新加载:
sudo systemctl reload nginx
如果访问仍然失败,可以继续检查 Nginx 的错误日志:
sudo tail -n 100 /var/log/nginx/error.log
比如出现 connect() failed (111: Connection refused),就应该优先检查 Nginx 配置的上游地址、端口以及 Spring Boot 的监听状态。
五、我的排查顺序
遇到部署后无法访问的问题,我建议按照下面的顺序逐层验证:
第一步:确认进程
检查 Java 进程是否存在,应用日志是否有异常。
第二步:确认端口
通过 ss 查看端口是否监听,再使用 curl 测试本机接口。
第三步:确认反向代理
检查 Nginx 是否启动、代理地址是否正确,以及是否存在 502、504 等错误。
第四步:确认网络规则
检查华为云 ECS 的公网 IP、安全组入方向规则以及系统防火墙。
第五步:确认域名和 HTTPS
如果 IP 访问正常,但域名访问失败,再检查 DNS 解析、证书配置和 HTTPS 相关问题。
这里还有一点容易忽略:服务器可以访问外部网络,并不代表外部用户一定可以访问服务器。入站和出站是两个不同方向的网络问题。
六、最后总结
Spring Boot 项目部署到云服务器,其实不只是把 JAR 包上传并运行这么简单。
从用户浏览器到 Java 应用,中间可能经过:
DNS → 公网 IP → 安全组 → 系统防火墙 → Nginx → Spring Boot
每一层都可能造成请求无法正常到达应用。
因此,与其不断修改配置碰运气,不如先确定请求在哪一层出现了问题。
我觉得云服务器部署排障最重要的不是记住多少命令,而是建立清晰的排查顺序。这样以后不管使用哪家云平台,遇到类似问题都能更快定位原因。
以上是一些 Java Web 项目上云时可以参考的实践思路。如果大家遇到过比较特殊的网络或者部署问题,也欢迎一起交流。
参考资料: 华为云 ECS 官方文档《配置安全组规则》
https://support.huaweicloud.cn/usermanual-ecs/zh-cn_topic_0030878383.html
- 点赞
- 收藏
- 关注作者
评论(0)