### 在 Docker + FastAPI 商城项目中配置和连接数据库后端 为了实现一个完整的商城项目，需要将 FastAPI 后端与数据库集成并通过 Docker 容器化管理。以下是详细的解决方案。 --- #### 1. 数据库环境变量配置 在 `docker-compose.yml` 文件中定义数据库服务及其连接参数。通过设置 `environment` 变量，可以将数据库 URI 注入到应用程序容器中。例如： ```yaml version: '3.9' services: app: build: . ports: - "8000:8000" depends_on: - db environment: - DATABASE_URI=mysql+pymysql://username:password@db/database_name volumes: - .:/app db: image: mysql:8.0 restart: always environment: MYSQL_ROOT_PASSWORD: root_password MYSQL_DATABASE: database_name MYSQL_USER: username MYSQL_PASSWORD: password ports: - "3306:3306" ``` 在此配置中，`depends_on` 确保了 `app` 容器启动之前先启动 `db` 容器[^1]。同时，`DATABASE_URI` 被设置为 MySQL 的连接字符串，其中 `@db` 表示使用服务名称作为主机名，Docker Compose 会将其解析为内部网络中的 IP 地址。 --- #### 2. SQLAlchemy 配置 在 FastAPI 应用程序中，可以通过 SQLAlchemy 来管理和操作数据库。首先，在项目的入口文件（如 `main.py` 或 `database.py`）中导入必要模块并初始化引擎和会话工厂： ```python from sqlalchemy import create_engine from sqlalchemy.orm import sessionmaker from sqlalchemy.ext.declarative import declarative_base DATABASE_URI = os.getenv('DATABASE_URI') engine = create_engine(DATABASE_URI, pool_pre_ping=True) SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine) Base = declarative_base() ``` 此处的 `pool_pre_ping=True` 参数用于检测连接是否仍然有效，防止因长时间闲置而导致断开连接的问题。 --- #### 3. Alembic 数据库迁移工具 为了方便地维护数据库模式变更历史记录，推荐使用 Alembic 进行版本控制。初始化 Alembic 并生成初始修订版命令如下： ```bash alembic init alembic alembic revision --autogenerate -m "Initial migration" alembic upgrade head ``` 编辑 `alembic.ini` 文件以指定目标数据库 URL： ```ini sqlalchemy.url = %(env.DATABASE_URI)s ``` 这使得每次执行迁移时都能从环境中获取最新的数据库连接信息。 --- #### 4. 构建和运行 Docker 容器 完成上述步骤之后，就可以构建镜像并将应用部署至本地测试环境。具体指令包括但不限于以下几条： - **构建镜像** ```bash docker compose build ``` - **启动服务** ```bash docker compose up -d ``` 如果希望清理所有停止的服务及相关资源，则可运行： ```bash docker compose down --volumes ``` 另外，当单独调试某个组件或者验证特定功能点的时候，也可以采用手动方式启动单个容器实例[^4]: ```bash docker run -d --name fastapi-app -p 8000:8000 your_image_tag ``` --- #### 5. 日志监控与错误排查 建议在项目根目录新增专门的日志保存路径以便后续分析潜在异常情况。比如可以在 `docker-compose.yml` 添加类似这样的挂载声明[^3]: ```yaml volumes: - ./logs:/app/logs ``` 如此一来，任何由 Python 打印出来的消息都会被重定向存储至宿主机对应子目录之下供查阅参考。 --- ###