连接MySQL容器并创建数据库失败问题求助

一、ERROR 1049 (42000): Unknown database 'access_log' 错误解决 #

问题原因 #

1. MySQL容器仅在首次启动且数据卷为空时执行初始化逻辑，若本地./db/data目录已有旧数据，MYSQL_DATABASE环境变量不会自动重新创建目标数据库。
2. Docker Compose中MYSQL_USER设为root存在冲突：root是MySQL默认超级用户，MYSQL_USER字段应用于创建普通业务用户，该配置可能干扰数据库初始化流程。

解决步骤 #

1. 清理旧数据卷并重新初始化

   # 停止容器并彻底删除关联数据卷
   docker-compose down -v
   # 重新构建并启动服务，触发数据库初始化
   docker-compose up -d --build
   

2. 修正Docker Compose环境变量配置
   修改db服务的环境变量，避免用root作为业务用户：

   environment:
     MYSQL_DATABASE: 'access_log'
     MYSQL_USER: 'app_user'  # 改为普通业务用户，避免与root冲突
     MYSQL_PASSWORD: 'app_pass'  # 新增普通用户密码
     MYSQL_ROOT_PASSWORD: 'password'
   

   同步更新app.py中的连接配置：

   server_config={
       'user': 'app_user',
       'password': 'app_pass',
       'host': 'db',
       'database': 'access_log',
       'port': 3306,
   }
   

二、mysql.connector.errors.InterfaceError: 2003 连接错误解决 #

问题原因 #

1. 服务就绪延迟：depends_on仅保证容器启动顺序，不确保MySQL服务完全就绪，Flask应用启动时可能尝试连接未初始化完成的数据库。
2. 版本兼容问题：错误提示中的格式化报错通常由mysql-connector-python版本不兼容导致，部分版本存在参数解析bug。
3. 连接复用风险：全局连接对象可能因数据库重启、网络波动失效，未做重连处理。

解决步骤 #

1. 添加数据库连接重试逻辑
   修改app.py中的连接代码，确保MySQL服务就绪后再建立连接：

   import time
   from mysql.connector.errors import InterfaceError
   
   server_config={
       'user': 'app_user',
       'password': 'app_pass',
       'host': 'db',
       'database': 'access_log',
       'port': 3306,
   }
   
   # 最多重试10次，每次间隔2秒
   conn = None
   for _ in range(10):
       try:
           conn = mysql.connector.connect(**server_config)
           break
       except InterfaceError:
           print("MySQL服务未就绪，等待重试...")
           time.sleep(2)
   if not conn:
       raise Exception("无法连接到MySQL数据库")
   

2. 锁定mysql-connector-python版本
   在requirements.txt中指定稳定版本，避免兼容问题：

   flask==2.3.3
   mysql-connector-python==8.0.33
   

3. 优化连接使用方式
   避免长期持有全局连接，建议使用连接池或临时连接：

   from mysql.connector.pooling import MySQLConnectionPool
   
   # 初始化连接池
   pool = MySQLConnectionPool(pool_name="access_log_pool",
                             pool_size=5,
                             **server_config)
   
   # 在路由中获取并使用连接
   @app.route('/')
   def home():
       conn = pool.get_connection()
       try:
           cursor = conn.cursor(dictionary=True)
           cursor.execute(sql, val)
           conn.commit()
       finally:
           conn.close()
       # 其他逻辑...
   

验证步骤 #

登录MySQL容器确认数据库状态：

docker exec -it db mysql -uroot -ppassword
# 查看数据库列表
SHOW DATABASES;
# 切换到目标数据库并检查表
USE access_log;
SHOW TABLES;

内容的提问来源于stack exchange，提问作者Inbar Manor