解决Gunicorn和Flask应用崩溃后无法自动重启的问题

在使用Gunicorn部署Flask应用时，很多开发者会遇到应用崩溃后无法自动重启的情况，导致服务中断影响业务正常运行。本文将结合实际场景，介绍几种可行的解决方案，帮助大家实现应用异常后的自动恢复。

问题背景

Gunicorn本身是一个WSGI HTTP服务器，默认情况下如果工作进程（worker）因为异常退出，Gunicorn会自动重启新的worker进程。但如果是主进程崩溃、或者应用启动时依赖的资源不可用导致启动失败，默认配置下可能无法自动恢复。另外如果Flask应用内部出现未捕获的异常导致整个服务挂掉，也需要额外的机制保障服务可用性。

方案一：使用Systemd管理Gunicorn服务

Linux系统下使用Systemd管理Gunicorn服务是最常用的方式，Systemd本身提供了进程崩溃自动重启的能力，配置简单且稳定。

1. 创建Systemd服务文件

首先创建服务配置文件，假设我们的Flask应用入口文件是app.py，项目路径为/opt/flask_demo，使用Python虚拟环境，虚拟环境路径为/opt/flask_demo/venv。

# 创建服务文件
sudo vim /etc/systemd/system/flask_gunicorn.service

文件内容如下：

[Unit]
Description=Flask Gunicorn Service
After=network.target

[Service]
# 运行服务的用户，根据实际需求修改
User=root
# 工作目录，设置为Flask项目根目录
WorkingDirectory=/opt/flask_demo
# 虚拟环境中的gunicorn路径
ExecStart=/opt/flask_demo/venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 app:app
# 进程崩溃后自动重启
Restart=always
# 重启间隔，单位秒
RestartSec=5
# 最大重启次数，0表示无限制
StartLimitInterval=0

[Install]
WantedBy=multi-user.target

配置说明：

• Restart=always：只要服务不是正常停止，都会自动重启，包括异常退出、被杀死等情况
• RestartSec=5：服务崩溃后等待5秒再重启，避免频繁重启消耗资源
• StartLimitInterval=0：取消重启频率限制，避免短时间内多次崩溃后Systemd停止重启服务

2. 启动并设置开机自启

配置完成后执行以下命令生效：

# 重新加载Systemd配置
sudo systemctl daemon-reload
# 启动服务
sudo systemctl start flask_gunicorn
# 查看服务状态，确认是否正常运行
sudo systemctl status flask_gunicorn
# 设置开机自启
sudo systemctl enable flask_gunicorn

方案二：使用Supervisor管理进程

如果服务器没有使用Systemd（比如部分旧版CentOS系统），可以使用Supervisor进程管理工具，它同样支持进程崩溃自动重启，还提供了Web管理界面方便查看进程状态。

1. 安装Supervisor

使用pip安装Supervisor，建议在虚拟环境中安装：

pip install supervisor
# 生成默认配置文件
echo_supervisord_conf > /etc/supervisord.conf

2. 配置Flask Gunicorn进程

编辑/etc/supervisord.conf，在文件末尾添加以下内容：

[program:flask_gunicorn]
# 虚拟环境中gunicorn的完整路径
command=/opt/flask_demo/venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 app:app
# 项目工作目录
directory=/opt/flask_demo
# 自动启动
autostart=true
# 进程退出后自动重启
autorestart=true
# 重启尝试次数
startretries=3
# 运行用户
user=root
# 重定向日志输出
stdout_logfile=/var/log/flask_gunicorn/stdout.log
stderr_logfile=/var/log/flask_gunicorn/stderr.log
# 日志文件大小限制，超过后自动切割
stdout_logfile_maxbytes=50MB
stderr_logfile_maxbytes=50MB

记得提前创建日志目录：

sudo mkdir -p /var/log/flask_gunicorn

3. 启动Supervisor服务

# 启动supervisord
supervisord -c /etc/supervisord.conf
# 查看进程状态
supervisorctl status

如果后续需要更新配置，执行以下命令重新加载：

supervisorctl reread
supervisorctl update

方案三：Gunicorn自身配置优化

除了外部进程管理工具，也可以调整Gunicorn的自身配置，增强异常恢复能力。

1. 调整Worker重启策略

Gunicorn的worker进程如果因为异常退出，默认会自动重启，但是可以通过参数调整重启行为：

# 启动命令中添加以下参数
# --max-requests：每个worker处理多少请求后自动重启，避免内存泄漏
# --max-requests-jitter：随机延迟，避免所有worker同时重启
# --timeout：worker处理请求的超时时间，超时后会被杀死重启
gunicorn -w 4 -b 0.0.0.0:5000 --max-requests 1000 --max-requests-jitter 50 --timeout 30 app:app

2. 捕获Flask应用全局异常

在Flask应用中添加全局异常捕获，避免未处理的异常导致整个worker进程退出：

from flask import Flask
import logging
from logging.handlers import RotatingFileHandler

app = Flask(__name__)

# 配置日志
handler = RotatingFileHandler('app.log', maxBytes=1024*1024*10, backupCount=5)
handler.setLevel(logging.ERROR)
app.logger.addHandler(handler)

# 全局异常捕获
@app.errorhandler(Exception)
def handle_exception(e):
    # 记录异常日志
    app.logger.error(f"全局异常捕获：{str(e)}", exc_info=True)
    # 返回友好的错误响应，避免直接抛出异常导致worker退出
    return {"code": 500, "message": "服务出现异常，请稍后重试"}, 500

@app.route('/')
def index():
    # 模拟可能出现的异常
    # raise ValueError("测试异常")
    return "Hello Flask"

if __name__ == '__main__':
    app.run()

上面的代码中，通过@app.errorhandler(Exception)捕获所有未处理的异常，记录日志后返回标准错误响应，而不是直接抛出异常导致Gunicorn worker进程退出，减少不必要的进程重启。

方案四：结合健康检查实现主动恢复

如果应用因为依赖的数据库、缓存等服务不可用导致启动失败，可以在启动脚本中添加健康检查逻辑，等待依赖服务可用后再启动Gunicorn。

创建启动脚本start.sh：

#!/bin/bash
# 等待数据库服务可用，这里以MySQL为例，端口3306
while ! nc -z 127.0.0.1 3306; do
    echo "数据库服务未就绪，等待5秒后重试..."
    sleep 5
done

echo "依赖服务就绪，启动Gunicorn"
# 启动Gunicorn
/opt/flask_demo/venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 app:app

给脚本添加执行权限，然后修改Systemd或者Supervisor的启动命令为执行这个脚本即可：

chmod +x /opt/flask_demo/start.sh

总结

解决Gunicorn和Flask应用崩溃后无法自动重启的问题，优先推荐使用Systemd或者Supervisor这类进程管理工具，它们本身提供了成熟的崩溃重启机制，配置简单且稳定。同时可以结合Gunicorn的参数优化和Flask的全局异常捕获，进一步减少异常发生的概率。如果应用依赖外部服务，还可以添加启动前的健康检查逻辑，避免启动失败的情况。根据实际部署环境选择合适的方案，基本可以覆盖绝大多数自动重启的需求。

GunicornFlask自动重启SystemdSupervisor 本作品最后修改时间：2026-05-23 16:27:50