微信小程序+SpringBoot首次部署:从连接超时到成功的防火墙排错指南 腾讯云 轻量级服务器

148 阅读2分钟

核心问题定位

当遇到连接超时,可以快速通过以下两点进行定位:

  • 客户端表现: 小程序开发者工具控制台明确报出 CONNECTION_TIMED_OUT 错误。
  • 服务端表现: 后端服务(如SpringBoot)的控制台日志,在客户端发起请求后,没有任何新的日志输入。

结论: 当这两个现象同时出现,几乎可以100%确定问题出在网络链路上。请求从客户端发出后,在到达服务器的某个网络节点(通常是防火墙或安全组)被丢弃了。

解决方案:三步搞定防火墙

云服务器出于安全考虑,默认只开放少数常用端口(如80, 443, 22)。我们自定义的服务端口(本文以9090为例)需要手动"放行"。

第一步:找到防火墙配置

登录你的云服务商控制台(如腾讯云、阿里云等),进入你购买的服务器实例管理页面,找到 【防火墙】【安全组】 菜单。

第二步:添加新规则

点击"添加规则"或类似按钮,创建一条新的入站规则

第三步:填写规则

  • 来源/源IP: 0.0.0.0/0 或者 允许所有IPV4 (表示允许来自任何IP的访问,如果出于安全考虑可以设置为特定IP)
  • 协议端口: TCP:9090 (将9090替换为你的服务实际使用的端口)
  • 策略: 允许 / Accept

保存规则即可,该设置通常是实时生效的,无需重启服务器或应用。

额外小贴士

  • 验证方式: 规则添加后,立刻回到小程序或使用Postman等工具再次请求API,如果能正常返回数据,问题即解决。
  • 安全组 vs 防火墙: 不同云服务商的叫法可能不同,腾讯云轻量应用服务器叫"防火墙",而CVM和阿里云ECS通常叫"安全组",但其作用和配置逻辑是完全一致的,都是管理服务器实例的网络访问控制。
  • 微信开发者工具缓存: 如果登录后发现用户不对,记得在开发者工具顶部菜单栏【清除缓存】->【清除全部缓存】,以模拟新用户登录。