signal 15是什么含义？部署FastAPI到Heroku报该错误如何解决？

Signal 15的具体含义 #

Signal 15又名SIGTERM，是类Unix操作系统中默认的进程终止信号。该信号允许进程捕获后执行资源清理、连接关闭等收尾操作，实现优雅退出，区别于不可被捕获、直接强制终止进程的Signal 9（SIGKILL）。

本次报错的根因说明 #

你提供的日志中Reason: Worker failed to boot是核心错误信息，Signal 15只是终止操作的表象：你的FastAPI服务使用的Uvicorn/Gunicorn worker进程启动失败，Heroku平台检测到进程异常后，主动发送SIGTERM信号终止整个服务进程组，最终导致应用状态变为crashed。

问题排查步骤 #

• 校验端口绑定配置：Heroku会为web进程动态分配端口，禁止硬编码固定端口，启动命令必须读取系统PORT环境变量，示例启动命令：uvicorn main:app --host 0.0.0.0 --port $PORT
• 校验依赖配置：确认requirements.txt文件包含所有项目依赖，且版本无冲突，必须包含fastapi、uvicorn（或gunicorn+uvicorn worker）等运行必需的依赖包
• 校验启动配置：确认项目根目录的Procfile文件配置正确，web进程的启动命令指向正确的应用入口文件及FastAPI实例名，示例配置：web: gunicorn main:app -w 2 -k uvicorn.workers.UvicornWorker
• 本地复现验证：使用与Heroku环境一致的Python版本，安装同版本依赖后执行Procfile中的启动命令，排查是否存在导入错误、配置缺失等本地即可复现的启动异常
• 检查资源超限问题：Heroku免费dyno的内存上限为512MB，若应用启动时内存占用超出阈值也会触发worker启动失败，可执行heroku logs --dyno web --tail拉取完整运行日志，排查是否存在内存不足相关报错

内容的提问来源于stack exchange，提问作者Shadrach Adamu