CentOS 中 Postman 网络连接问题排查与修复
一 快速定位问题范围
- 区分是本机网络还是目标服务问题：在终端执行 curl 验证，例如 curl -v http://目标主机:端口/健康检查。若 curl 也失败，多半是网络/防火墙/服务未监听；若 curl 成功而 Postman 失败，优先检查 Postman 的代理与SSL设置。必要时在 Postman 中开启详细日志，并确认请求方法、URL、请求头与请求体是否与 curl 一致。
二 在公司代理或受限网络环境下
- 设置系统代理环境变量（对大多数命令行与 Electron 应用生效）：
- 编辑 ~/.bashrc 或 ~/.bash_profile，加入：
- export http_proxy=http://代理地址:端口
- export https_proxy=http://代理地址:端口
- 使配置生效：source ~/.bashrc（或 source ~/.bash_profile）
- 在 Postman 内同步代理：
- 打开右上角齿轮 → Settings → General → Proxies，在 HTTP Proxy 与 SSL Proxy 填入与系统一致的代理地址与端口；如无需代理，保持为空。
- 验证与回退：
- 执行 env | grep -i proxy 检查变量是否生效；若怀疑代理导致本地服务访问异常，可在 Postman 的 Proxies 中临时清空或仅对特定目标禁用代理。
三 服务器侧与防火墙排查（目标主机在 CentOS 上）
- 检查服务是否监听正确端口与地址：ss -tulpen | grep 端口 或 netstat -tulpen | grep 端口，确认监听在 0.0.0.0:端口 而非仅 127.0.0.1。
- 如使用 firewalld（CentOS 7+ 常用）：
- 查看状态：firewall-cmd --state
- 开放端口（示例为 5000/tcp）：firewall-cmd --zone=public --add-port=5000/tcp --permanent
- 使配置生效：firewall-cmd --reload
- 如需临时放行全部端口（仅测试环境）：systemctl stop firewalld
- 端口连通性测试（从 Postman 所在机器发起）：
- telnet 目标主机 端口 或 nc -vz 目标主机 端口，能连通则网络与防火墙基本无碍；连不通则回到上一步开放端口或检查云安全组/运营商策略。
四 常见错误与对应处理
- 出现 503 Forwarding failure / Service Unavailable：常见于目标端口未对外开放、服务未启动或反向代理/网关转发异常。先确认服务已监听、端口已放行，再检查上游网关与健康检查配置。
- SSL 证书错误：测试环境可在 Postman 中临时关闭 SSL 证书验证；生产环境应导入受信任 CA证书或修复服务端证书链与域名匹配问题。
- 连接超时：优先用 curl 与 telnet 验证网络路径与端口可达性，再检查防火墙/安全组/服务绑定地址是否正确。
五 一键排查清单
- 在 Postman 中核对：请求方法、URL、请求头/体、认证信息是否与 curl 一致；必要时开启详细日志。
- 在终端执行：curl -v 目标URL；若失败，继续 telnet 目标主机 端口 验证连通性。
- 在服务端：ss -tulpen | grep 端口 确认监听；firewall-cmd --list-ports 与 firewall-cmd --reload 确保端口放行。
- 若处于公司网络：env | grep -i proxy 检查代理变量；在 Postman → Settings → General → Proxies 同步或清空代理设置。