Spring Boot 部署到华为云 ECS 后无法访问?分享几个实用的排查思路

举报
yd_271909534 发表于 2026/11/12 09:11:41 2026/11/12
【摘要】 Spring Boot 项目部署到华为云 ECS 后,可能遇到应用启动正常却无法通过公网访问的问题。本文从 Java 进程、端口监听、安全组、防火墙和 Nginx 反向代理等方面,整理一套逐层定位故障的排查思路,适合 Java 后端开发者参考。

最近在整理 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

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。