Gunicorn 19.7.1如何设置重试限制？应用失败后停止而非多次重启

针对你的需求，先直接给出结论：Gunicorn 19.7.1 没有内置的专门配置项来设置应用运行失败后的重试次数上限——默认情况下，master进程会无限重启崩溃或启动失败的worker进程。不过你可以通过以下几种替代方案实现「失败后直接停止」的效果：

• 方式一：外部监控脚本
  编写一个简单的shell脚本，启动Gunicorn后持续监控worker进程状态，一旦检测到worker崩溃，立即终止Gunicorn主进程。示例脚本如下：

  #!/bin/bash
  # 启动Gunicorn后台进程
  gunicorn --workers=1 your_app:app &
  GUNICORN_PID=$!
  # 获取worker进程ID
  WORKER_PID=$(pgrep -P $GUNICORN_PID)
  
  while true; do
      # 检查worker是否存活
      if ! ps -p $WORKER_PID > /dev/null; then
          echo "Worker进程崩溃，终止Gunicorn主进程..."
          kill $GUNICORN_PID
          exit 1
      fi
      sleep 2
  done
  

• 方式二：自定义Worker类
  如果你通过Python代码启动Gunicorn，可以自定义Worker类，在worker退出时触发master进程终止。示例代码如下：

  from gunicorn.workers.sync import SyncWorker
  from gunicorn.app.base import BaseApplication
  from your_app import app  # 导入你的Flask/Django应用
  
  class NoRestartWorker(SyncWorker):
      def handle_exit(self, sig, frame):
          # worker退出时，终止master进程
          self.parent_pid.kill()
          super().handle_exit(sig, frame)
  
  class StandaloneGunicorn(BaseApplication):
      def __init__(self, app, options=None):
          self.options = options or {}
          self.application = app
          super().__init__()
  
      def load_config(self):
          config = {k: v for k, v in self.options.items() if k in self.cfg.settings}
          for k, v in config.items():
              self.cfg.set(k.lower(), v)
  
      def load(self):
          return self.application
  
  if __name__ == '__main__':
      run_options = {
          'workers': 1,
          'worker_class': '__main__.NoRestartWorker',
      }
      StandaloneGunicorn(app, run_options).run()
  

• 方式三：--preload参数（仅适用于启动阶段失败）
  如果你的应用在初始化阶段就会失败（比如数据库连接错误、配置加载失败），可以添加--preload参数让Gunicorn在master进程中预先加载应用代码。这样一旦应用初始化失败，master进程会直接退出，不会尝试重启worker。但这个方法对运行中崩溃的worker无效。

另外补充一点：如果你能升级到Gunicorn 20.0.0及以上版本，就可以直接使用官方内置的--max-failures配置项，设置允许的worker启动失败次数，超过后master自动退出。比如：

gunicorn --max-failures=1 your_app:app

内容的提问来源于stack exchange，提问作者Le Duong Tuan Anh