嵌入式Linux板Flask服务Gunicorn多Worker配置致Socket端口占用问题

问题根源 #

你的Flask应用里的Socket服务器，会在每个Gunicorn Worker进程启动时初始化并尝试绑定端口。当Worker数设为1时，只有一个进程绑定端口，运行正常；但Worker数>1时，多个进程同时抢占同一个端口，就会触发[Errno 98] Address already in use错误。

具体解决方案 #

1. 重构Socket服务器的初始化逻辑 #

把Socket的绑定、监听逻辑从Worker进程的初始化流程中剥离，避免重复绑定：

• 只让Gunicorn的主进程初始化Socket服务器，Worker进程通过共享句柄的方式处理连接。可以借助Gunicorn的post_fork钩子实现，或者在代码里通过判断进程PID，只在主进程执行Socket绑定操作。
• 简单示例（通过进程PID判断）：

  import os
  from flask import Flask
  
  app = Flask(__name__)
  socket_server = None
  
  def init_socket():
      global socket_server
      # 这里写入你的Socket服务器初始化、绑定逻辑
      pass
  
  # 仅在Gunicorn主进程中初始化Socket
  if os.getpid() == int(os.environ.get('GUNICORN_PID', os.getpid())):
      init_socket()
  

2. 优化Gunicorn Worker参数（适配嵌入式设备） #

嵌入式设备资源有限，别盲目堆Worker数，合理组合Worker和线程：

• 保持worker-class=gthread（线程型Worker比多进程更节省内存，适合嵌入式场景），Worker数建议设为CPU核心数 + 1（比如设备是2核，就设--workers 2），线程数根据业务压力调整（比如--threads 3或4）。
• 示例启动命令：

  ExecStart=gunicorn --bind 0.0.0.0:443 --workers 2 --threads 4 --worker-class=gthread --timeout 600 wsgi:app
  

3. 清理残留进程 #

先检查443端口是否被残留的Gunicorn进程占用：

netstat -tulpn | grep :443

如果有残留进程，直接杀掉：

pkill gunicorn

再重新启动服务。

4. 改用Unix Socket（可选） #

如果你的服务不需要对外暴露TCP端口，用Unix Socket能彻底避免端口冲突，还能提升本地通信效率：
修改启动命令：

ExecStart=gunicorn --bind unix:/tmp/flask_web.sock --workers 2 --threads 4 --worker-class=gthread --timeout 600 wsgi:app

后续如果搭配反向代理（比如Nginx），直接配置Socket路径即可。

内容的提问来源于stack exchange，提问作者Selçuk Gök