FastAPI 项目配置、多环境和部署上线

uvicorn app.main:app --reload

数据库地址是不是生产库
JWT_SECRET 有没有换成强密钥
Redis 密码有没有配置
前端请求能不能转到后端
接口挂了有没有健康检查
日志去哪看
HTTPS 有没有配置

from pydantic_settings import BaseSettings


class Settings(BaseSettings):
    APP_ENV: str = "development"
    DATABASE_URL: str
    REDIS_URL: str
    JWT_SECRET: str
    CORS_ORIGINS: list[str] = []
    LOG_LEVEL: str = "INFO"

    class Config:
        env_file = ".env"


settings = Settings()

APP_ENV=development
DATABASE_URL=postgresql+asyncpg://postgres:password@localhost:5432/appdb
REDIS_URL=redis://localhost:6379/0
JWT_SECRET=change-me
CORS_ORIGINS=["http://localhost:3000"]
LOG_LEVEL=INFO

APP_ENV=test
DATABASE_URL=postgresql+asyncpg://postgres:testpass@test-db:5432/appdb
REDIS_URL=redis://test-redis:6379/0
JWT_SECRET=test-random-secret
CORS_ORIGINS=["https://test.example.com"]
LOG_LEVEL=INFO

APP_ENV=production
DATABASE_URL=postgresql+asyncpg://app:strongpass@prod-db:5432/appdb
REDIS_URL=redis://:strongpass@prod-redis:6379/0
JWT_SECRET=very-long-random-secret
CORS_ORIGINS=["https://example.com"]
LOG_LEVEL=WARNING

api FastAPI 服务
db PostgreSQL
redis 缓存
nginx 反向代理

services:
  api:
    build: .
    env_file:
      - .env.prod
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: appdb
      POSTGRES_USER: app
      POSTGRES_PASSWORD: strongpass
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app -d appdb"]
      interval: 5s
      timeout: 5s
      retries: 10

  redis:
    image: redis:7-alpine

volumes:
  pgdata:

用户访问 https://example.com
  ↓
Nginx 接住请求
  ↓
/api 转给 FastAPI
静态页面直接返回

location /api/ {
  proxy_pass http://api:8000/api/;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
}

用户记 example.com，不用记服务器 IP

浏览器和服务器之间的数据加密传输

@app.get("/health")
async def health():
    return {"status": "ok"}

@app.get("/health")
async def health(db: AsyncSession = Depends(get_db)):
    await db.execute(text("SELECT 1"))
    return {"status": "ok", "database": "ok"}

明文密码
完整 token
身份证、手机号等敏感信息

1. 本地跑通测试
2. 构建 Docker 镜像
3. 上传或拉取代码到服务器
4. 准备 .env.prod
5. docker compose config 检查配置
6. docker compose up -d 启动
7. 执行数据库迁移
8. 检查 /health
9. 检查 Nginx 代理
10. 检查前端页面和接口联调

/health
/docs 或关键接口
登录
用户列表
新增/编辑/删除

[ ] .env.prod 已准备且不提交到公开仓库
[ ] JWT_SECRET 是强随机值
[ ] DATABASE_URL 指向正确数据库
[ ] CORS_ORIGINS 包含正式域名
[ ] Alembic migration 已执行
[ ] /health 正常
[ ] Nginx /api 能转发到后端
[ ] HTTPS 正常
[ ] 数据库有持久化和备份方案
[ ] 登录、列表、新增、编辑、删除已验收