Postman在CentOS上的常见错误代码与含义
HTTP响应状态码
- 400 Bad Request：请求语法错误或参数不符合接口定义。检查请求方法（如GET/POST）、请求头（如Content-Type: application/json）、以及参数类型与必填项。
- 404 Not Found：请求的路径不存在或路由未配置。核对URL与接口文档，确认服务已部署到对应路径与端口。
- 503 Service Unavailable（Forwarding failure）：上游服务不可用或目标端口未开放。常见于目标主机未监听该端口、被firewalld拦截或应用未启动。需在服务器放行端口（如firewall-cmd --zone=public --add-port=5000/tcp --permanent && firewall-cmd --reload）并确认服务已监听。
客户端运行与依赖错误
- 启动时报错：error while loading shared libraries: libXss.so.1: cannot open shared object file。这是缺少屏幕保护库，执行：sudo yum install libXScrnSaver 后重试。
- 其他可能的依赖缺失（如在部分桌面环境或版本中）：libgconf-2.so.4。可安装：sudo yum install libgconf-2-4。
- 安装/运行权限不足：确保解压目录可读可执行，必要时使用sudo或将Postman目录权限授予当前用户。
网络与SSL相关错误
- SSL证书验证失败（如自签名证书或证书链不完整）：在Postman中可临时关闭SSL验证用于排查，生产环境应导入受信任证书或修复证书链。
- 连接超时/网络不通：确认客户端到目标主机的网络连通性、端口可达性（云服务器需放行安全组与firewalld）、以及目标服务是否在监听对应端口。
快速排查清单
- 在Postman中打开控制台（View > Show Postman Console）查看请求与响应详情；核对URL、方法、Headers、Body。
- 在服务器侧确认监听与连通：ss -tulpen | grep <端口>；如未监听，启动服务；如监听但仍不通，检查firewalld与安全组规则。
- 若报依赖错误，安装缺失库（如libXScrnSaver、libgconf-2-4）；必要时更新Postman至最新版本。
