彻底解决:80 端口 GET/POST 正常,PUT 却报 ERR_CONNECTION_RESET?

太长不看版(结论):

如果你的代码本地运行完美,上线后仅 80/443 端口PUT/DELETE 请求报错(Connection Reset),而其他端口(如 8080)正常。
不用查代码了,99% 是内网 WAF 或防火墙把 80 端口的非 GET/POST 请求拦截了!


一、 快速自查:是不是遇到了这种情况?

在排查前,请对比症状:

  • 环境架构: Vue3 + Nginx (80端口) -> Java 后端 (8082端口)
  • GET/POST 成功
  • PUT/DELETE 报错: 浏览器控制台爆红 net::ERR_CONNECTION_RESET,感觉连接瞬间被掐断。
  • 绕过 Nginx 就好了: 前端如果直连后端 Java 端口(如 8082),PUT 请求是通的。
  • 换个端口也通了: 把 Nginx 监听从 80 改成 8888,发现 PUT 也通了。

二、 逐层排查(看看到底哪层出了鬼)

遇到这种问题,我们要像剥洋葱一样,从内到外一层层排除,直到抓到真凶。

第一步:排除后端代码

  • 操作:服务器本地 执行 curl -X PUT http://127.0.0.1:8082/api/test
  • 结果: 成功。说明后端 Java 程序支持 PUT,代码没写错。

第二步:排除 Nginx 配置

  • 操作: 在服务器本地,执行 curl -X PUT http://127.0.0.1:80/api/test(即走 80 端口转发)。
  • 结果: 成功
  • 结论: 只要流量不出服务器网卡 ,80 端口的 PUT 就是通的。这说明 Nginx 转发逻辑和配置文件(如 proxy_pass)都是对的。

第三步:排查是否网络拦截?

  • 对比实验: 修改 Nginx 配置文件,监听端口从 80 改为 8090,重启 Nginx。
  • 结果: 浏览器再次请求,成功了
  • 真相: 拦截发生在浏览器和服务器之间。

三、 分析:那为什么 80 端口会被"特殊照顾"?

为什么 80 端口的 PUT 请求会被防火墙直接发 RST 信号强行断开?

  1. 策略太保守: 很多老旧的防火墙或 WAF(Web 应用防火墙)认为 80/443 是标准 Web 端口,只应该跑 GET 和 POST。PUT 和 DELETE 被视为"写文件/删文件"的高危操作,默认直接干掉。
  2. 防火墙通常对 8090、8082 这种"非标端口"管得比较松,这些被认为是内部测试用的,扫描策略没那么严,所以反而能"躲过一劫"。
  3. 连接重置的本质: 当防火墙检测到 80 端口出现了它不喜欢的 PUT 包,它会伪装成目标服务器给浏览器发一个 RST 包 。浏览器以为服务器"挂了"或者"拒接",于是报错 CONNECTION_RESET

四、 避坑总结:三步走解决问题

以后再遇到类似的"本地通,上线挂"的问题,直接三步走:

  1. 本地 Curl 试一下: 排除后端代码嫌疑。
  2. 回环地址(127.0.0.1)试一下: 排除 Nginx 配置嫌疑。
  3. 换个非 80 端口试一下: 如果换端口好了,就把问题甩给运维,让他们开防火墙策略。

写在最后:

如果"流量不出网卡是好的,一出网卡就炸了"。那这种问题往往不在代码,而在那些看不见的网络黑盒里。


如果你觉得这篇排雷笔记有用,欢迎点赞、收藏!如有疑问,评论区见。

相关推荐
皮皮林55140 分钟前
利用闲置 Mac 从零部署 OpenClaw 教程 !
java
_AaronWong3 小时前
Electron 实现仿豆包划词取词功能:从 AI 生成到落地踩坑记
前端·javascript·vue.js
wuhen_n4 小时前
双端 Diff 算法详解
前端·javascript·vue.js
爱勇宝4 小时前
别再混用了!import.meta.env 与 process.env 的本质差异一次讲透
前端·javascript·vue.js
洋洋技术笔记6 小时前
Spring Boot配置管理最佳实践
spring boot
华仔啊6 小时前
挖到了 1 个 Java 小特性:var,用完就回不去了
java·后端
SimonKing6 小时前
SpringBoot整合秘笈:让Mybatis用上Calcite,实现统一SQL查询
java·后端·程序员
从文处安21 小时前
「九九八十一难」组合式函数到底有什么用?
前端·vue.js
日月云棠1 天前
各版本JDK对比:JDK 25 特性详解
java
用户11489669441051 天前
VUE3响应式原理——从零解析
vue.js