Error: POST predict 连接拒绝，127.0.0.1:11060 服务未启动

Question

问题：调用本地模型推理接口时出现“Error: POST predict 连接拒绝，127.0.0.1:11060 服务未启动”错误，常见原因是什么？如何排查和解决？请结合服务进程、端口占用、启动命令及防火墙配置等方面进行分析。

Answer 1

一、问题现象与初步理解

在调用本地部署的模型推理接口时，出现如下错误提示：

Error: POST predict 连接拒绝，127.0.0.1:11060 服务未启动

该错误表明客户端尝试通过 POST 请求访问运行在本机 127.0.0.1:11060 的服务端点（如 /predict），但连接被拒绝。这通常意味着目标服务未正常监听指定端口。

从系统角度看，此问题可能涉及以下几个层面：

• 服务进程是否已成功启动
• 目标端口（11060）是否被正确绑定并监听
• 启动命令是否存在配置错误
• 操作系统防火墙或安全策略是否阻止了本地通信

二、常见原因分类分析

层级	可能原因	影响范围
应用层	模型服务未启动或崩溃退出	完全无法访问
网络层	端口未监听或绑定失败	连接被拒绝
配置层	启动脚本中端口号错误或参数缺失	服务未按预期运行
系统层	端口被其他进程占用	绑定冲突导致启动失败
安全层	防火墙/SELinux限制本地回环通信	即使服务运行也无法连接

三、排查流程图（Mermaid 格式）

graph TD
    A[出现连接拒绝错误] --> B{检查服务进程是否存在}
    B -- 否 --> C[启动服务或查看日志]
    B -- 是 --> D{端口11060是否监听}
    D -- 否 --> E[检查端口占用或绑定IP]
    D -- 是 --> F{防火墙是否放行}
    F -- 否 --> G[配置iptables/firewalld]
    F -- 是 --> H[检查服务绑定地址是否为0.0.0.0或127.0.0.1]
    H --> I[使用curl测试本地连通性]
    I --> J[定位至具体配置项修正]

四、详细排查步骤与解决方案

1. 确认服务进程状态：使用以下命令检查是否有相关服务在运行：

   ps aux | grep python.*11060

   或更通用地搜索占用该端口的进程。
2. 验证端口监听情况：

   netstat -tuln | grep 11060

   若无输出，则说明服务未监听；若显示 LISTEN 状态，则继续下一步。
3. 检测端口占用：

   lsof -i :11060

   如果返回非预期进程（如旧实例、调试服务），需终止之：

   kill -9 <PID>

4. 检查服务启动命令：确保启动脚本中明确指定了端口，例如：

   python app.py --host 0.0.0.0 --port 11060

   若使用 Flask/Tornado/FastAPI 框架，遗漏 --host 0.0.0.0 可能导致仅绑定 IPv6 或默认 localhost。
5. 查看服务日志输出：启动时添加日志重定向：

   python model_server.py > server.log 2>&1 &

   观察是否报错“Address already in use”或“Permission denied”。
6. 测试本地回环可达性：

   curl -v http://127.0.0.1:11060/predict

   根据响应判断是服务未响应还是路由未定义。
7. 检查防火墙设置：尽管是本地通信，某些企业环境仍启用严格策略：

   sudo firewall-cmd --list-ports | grep 11060

   必要时开放端口：

   sudo firewall-cmd --add-port=11060/tcp --permanent && sudo firewall-cmd --reload

8. SELinux/AppArmor 干扰排查：在 CentOS/RHEL 上可临时禁用 SELinux 测试：

   setenforce 0

   若问题消失，则需调整策略而非永久关闭。
9. Docker 容器场景特殊处理：若服务运行于容器内，需确保端口映射正确：

   docker run -p 11060:11060 model-inference-image

   并检查容器内部是否监听 0.0.0.0 而非 127.0.0.1。
10. 代码级绑定地址检查：部分框架默认绑定到 127.0.0.1，需显式改为 0.0.0.0 才能接受外部请求（包括本地跨进程调用）。