Postman 报错 Error: connect ECONNREFUSED 127.0.0.1:9090 表明客户端尝试连接本地 9090 端口时，该端口无服务监听或连接被主动拒绝，核心原因通常是后端服务未启动、端口配置不匹配或网络代理干扰。
postman 报错 `error: connect econnrefused 127.0.0.1:9090` 表明客户端尝试连接本地 9090 端口时，该端口无服务监听或连接被主动拒绝，核心原因通常是后端服务未启动、端口配置不匹配或网络代理干扰。
当你在 Postman 中发起请求（如 GET http://localhost:9090/api/xxx）却收到 connect ECONNREFUSED 127.0.0.1:9090 错误时，这不是 Postman 本身的问题，而是 TCP 层明确告知：“目标端口无人应答”。该错误本质是操作系统内核返回的 RST（复位）报文，意味着：没有进程在 127.0.0.1:9090 上监听连接请求。
✅ 必查三步诊断清单
1. 后端服务是否真正运行？
- 对于 Java/Spring Boot 项目，确认应用已成功启动：
# 查看是否有进程监听 9090 端口（Linux/macOS） lsof -i :9090 # 或 Windows 下 netstat -ano | findstr :9090
- 启动日志中必须出现类似提示：
Tomcat started on port(s): 9090 (http) with context path '' // 或 Spring Boot 的标准输出： Started Application in 3.212 seconds (JVM running for 3.789)
- ⚠️ 注意：Spring Boot 默认端口为 8080，若你未显式配置 server.port=9090（如在 application.yml 或 application.properties 中），则服务大概率运行在 8080 而非 9090。
2. 端口配置是否一致？
检查你的 Spring Boot 配置文件：
✅ 正确示例（application.yml）：
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
server: port: 9090 address: 0.0.0.0 # 允许所有接口访问（含 localhost）
✅ 或 application.properties：
server.port=9090 server.address=0.0.0.0
❌ 常见错误：
- 配置了 server.port=9090，但 IDE（如 IntelliJ）运行时未加载该 profile；
- 使用了 spring.profiles.active=prod，而 application-prod.yml 中端口仍为 8080；
- Maven 打包后通过 java -jar app.jar 启动，却未传参指定端口：
java -jar myapp.jar --server.port=9090
3. 排查代理与环境干扰
-
Postman 自身代理设置：进入 Settings → Proxy，确保：
- ❌ 取消勾选 Use the system proxy（尤其当 Fiddler/Charles 未运行时）；
- ✅ 若需自定义代理，请确认代理服务（如 127.0.0.1:8888）真实运行；
- Docker/WSL 场景注意：若后端运行在 WSL2 或容器中，localhost 在 Postman（Windows 主机）中不指向 WSL 内部服务，需改用 http://host.docker.internal:9090（Docker Desktop）或 http://<WSL2-IP>:9090。
- 防火墙/杀毒软件：临时禁用 Windows Defender 防火墙或第三方安全软件，测试是否拦截 9090 端口。
? 补充验证技巧
- 直接在浏览器访问 http://localhost:9090/actuator/health（若启用 Actuator）；
- 使用 curl 或 telnet 快速验证连通性：
curl -v http://localhost:9090 # 或（Windows） telnet localhost 9090
若连接立即失败（而非超时），即确认端口无监听。
? 总结
ECONNREFUSED 是一个“干净”的底层网络信号——它从不撒谎。它只说明一件事：目标端口上没有服务在等待连接。与其反复调试 Postman 请求，不如优先聚焦三件事：
① 服务进程是否存活；
② 配置端口是否与请求端口严格一致；
③ 运行环境（IDE、命令行、容器）是否真正加载了该配置。
修复后重启服务，再试 Postman，问题通常迎刃而解。
