InvenTree项目MySQL数据库容器化部署问题解析

问题背景

在使用InvenTree开源库存管理系统进行Docker容器化部署时，用户遇到了从默认PostgreSQL数据库切换到MySQL数据库时出现的表创建失败问题。本文将从技术角度分析该问题的成因，并提供完整的解决方案。

错误现象分析

从日志中可以观察到以下关键错误信息：

1. 数据库表创建失败："Table 'ERP.part_partpricing' doesn't exist"
2. 后台任务表不存在："Table 'ERP.django_q_schedule' doesn't exist"
3. 数据库未就绪："Database not ready for creating default report templates"

这些错误表明InvenTree系统在启动时尝试访问数据库表，但由于表结构未正确初始化导致失败。

根本原因

问题的核心在于Docker环境下数据库配置变更不完整。InvenTree默认使用PostgreSQL数据库，当用户切换为MySQL时，需要同时修改以下配置：

1. 数据库服务容器定义（docker-compose.yml）
2. 数据库连接参数（.env文件）
3. 数据库初始化流程

完整解决方案

1. 修改docker-compose.yml

需要将默认的PostgreSQL服务替换为MySQL服务配置：

inventree-db:
    image: mysql:9
    container_name: inventree-db
    expose:
        - 3306/tcp
    environment:
        - MYSQL_USER=${INVENTREE_DB_USER}
        - MYSQL_PASSWORD=${INVENTREE_DB_PASSWORD}
        - MYSQL_DATABASE=${INVENTREE_DB_NAME}
        - MYSQL_ROOT_PASSWORD=${INVENTREE_DB_ROOT_PASSWORD}
    volumes:
      - ./mysql_data:/var/lib/mysql
    restart: unless-stopped

2. 配置环境变量文件(.env)

需要设置正确的MySQL连接参数：

# 数据库类型配置
INVENTREE_DB_ENGINE=mysql
INVENTREE_DB_NAME=inventree
INVENTREE_DB_HOST=inventree-db
INVENTREE_DB_PORT=3306

# 数据库认证信息
INVENTREE_DB_USER=inventree_user
INVENTREE_DB_PASSWORD=secure_password
INVENTREE_DB_ROOT_PASSWORD=secure_root_password

3. 数据库初始化流程

完成配置修改后，需要执行以下步骤：

1. 停止并删除原有容器
2. 删除旧的数据库卷数据
3. 启动新的MySQL容器
4. 执行数据库迁移命令

技术要点说明

1. MySQL容器配置：使用官方MySQL镜像，注意版本兼容性（推荐MySQL 8+）
2. 数据持久化：通过volume挂载确保数据库数据持久化
3. 连接参数：必须确保InvenTree配置中的数据库引擎、主机名、端口与容器定义一致
4. 权限设置：MySQL需要root密码和普通用户密码分开配置

常见问题排查

如果仍然遇到表创建失败问题，可以检查：

1. MySQL容器日志，确认服务是否正常启动
2. 数据库用户是否有创建表的权限
3. 网络连接是否通畅（容器间通信）
4. 数据库字符集设置（推荐utf8mb4）

总结

InvenTree系统从PostgreSQL切换到MySQL需要完整的配置变更，包括容器定义、连接参数和初始化流程。正确理解Docker容器间的通信机制和数据库服务配置是解决此类问题的关键。通过本文提供的完整方案，开发者可以顺利完成InvenTree在MySQL环境下的容器化部署。