当 FastAPI 应用因内部错误主动退出时，需确保容器被 Docker 正确识别为“失败状态”，从而触发 restart: always 策略；直接发送 SIGTERM 到主进程往往无法实现预期重启，因其可能被 Uvicorn 拦截或未导致容器退出码非零。
当 fastapi 应用因内部错误主动退出时，需确保容器被 docker 正确识别为“失败状态”，从而触发 `restart: always` 策略；直接发送 `sigterm` 到主进程往往无法实现预期重启，因其可能被 uvicorn 拦截或未导致容器退出码非零。
在 Docker 和 Docker Compose 环境中，容器是否重启取决于其退出码（exit code） 和 Docker 的重启策略。restart: always 仅在容器进程以非零退出码终止、或被显式停止后才会触发重启。而你在 startup_event 中调用 os.kill(os.getpid(), signal.SIGTERM) 存在两个关键问题：
- Uvicorn 主进程会捕获并优雅处理 SIGTERM：它不会立即退出，而是执行 graceful shutdown 流程（包括运行 shutdown_event），最终以退出码 0 结束 —— 这被 Docker 视为“正常退出”，不会触发重启；
- os.kill() 作用于当前 Python 进程（即 Uvicorn worker），而非整个容器的 PID 1 进程（通常是 Uvicorn 启动器），因此无法强制容器级终止。
✅ 正确做法是：让应用进程以非零退出码终止，而非依赖信号。推荐以下两种可靠方案：
✅ 方案一：主动调用 sys.exit(1)（推荐）
替换 os.kill(...) 为：
import sys
@app.on_event("startup")
async def startup_event() -> None:
logging.info("VP: Starting Server")
task = asyncio.create_task(task_func())
try:
await task
except Exception as error:
logging.error(f"Following exception has occurred: {error}")
logging.critical("Critical task failure — exiting with error code 1 to trigger container restart")
sys.exit(1) # ← 关键：非零退出码，Docker 识别为崩溃
⚠️ 注意：sys.exit(1) 会终止当前进程并返回退出码 1，Docker 将其视为异常终止，配合 restart: always 即可自动重启容器。
✅ 方案二：结合健康检查 + 外部监控（适用于生产/K8s）
如答案中所述，在微服务或 Kubernetes 场景下，更健壮的方式是不依赖进程退出，而通过健康探针实现自动恢复：
- 添加 /status/health（liveness）和 /status/readiness（readiness）端点；
- 配置 livenessProbe 在健康检查失败时强制重启 Pod；
- 示例端点（集成 FastAPI）：
from fastapi import APIRouter, HTTPException from typing import Dict
status_router = APIRouter(prefix="/status", tags=["Status"])
@status_router.get("/health") def health() -> Dict[str, str]: return {"status": "ok"} # 始终返回 200，表示进程存活
@status_router.get("/readiness") async def readiness() -> Dict[str, str]:
可扩展：检查数据库、缓存、外部依赖等
if await check_critical_dependencies():
return {"status": "ok"}
raise HTTPException(status_code=503, detail="Service not ready")
并在 `docker-compose.yml` 中启用健康检查（Docker 本地支持）：
```yaml
events_consumer:
restart: always
build:
context: ./events_consumer
target: dev
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/status/health"]
interval: 30s
timeout: 5s
retries: 3
start_period: 40s
? 总结与最佳实践
- ❌ 避免在 FastAPI 中使用 os.kill(..., SIGTERM) 控制容器生命周期 —— 它与 Uvicorn 的信号处理机制冲突；
- ✅ 优先使用 sys.exit(1) 实现快速、确定性的容器重启；
- ✅ 生产环境建议同时配置 healthcheck（Docker）或 livenessProbe（Kubernetes），实现更细粒度的可用性治理；
- ? 验证重启行为：可通过 docker logs -f
观察日志循环，并用 docker inspect | grep -i "status\|exit" 查看最近退出码。
这样既保证了开发调试的简洁性，也兼顾了生产环境的可观测性与可靠性。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
