Docker部署MySQL+Python API项目仅改文件夹名可用，求排查原因

核心原因：Docker命名卷的残留权限数据 #

你的问题本质是Docker命名卷的持久化数据残留，具体逻辑如下：

• Docker Compose默认以项目文件夹名称作为项目标识，自动生成对应命名卷（例如原文件夹名_mysql_data），用来持久化MySQL的数据库数据（包括权限配置表）。
• 你执行的docker system prune -a命令默认不会清理卷资源（哪怕卷未被任何容器使用），必须加上--volumes参数才会删除未使用的卷。因此旧文件夹对应的MySQL卷一直保留，里面的权限配置还是错误状态（比如仅允许特定IP访问，或数据库用户权限未正确设置）。
• 修改文件夹名称后，Docker Compose会生成全新的命名卷（新文件夹名_mysql_data），此时MySQL会重新执行初始化脚本（比如创建允许任意IP访问的数据库用户），API自然能正常连接。
• 复制项目到新位置但不修改名称时，Docker Compose仍会复用旧的命名卷，权限问题持续存在，因此报错。

验证与解决步骤 #

1. 确认旧卷存在
   运行以下命令查看所有Docker卷：

   docker volume ls
   

   找到对应原故障文件夹名称的MySQL卷（格式通常为文件夹名_卷名，比如my_old_project_mysql_data）。

2. 清理旧卷并重启

   • 手动删除旧卷：

     docker volume rm 旧卷的完整名称
     

   • 或者修改你的清理命令，加入卷清理参数：

     docker system prune -a --volumes && docker-compose up --build --force-recreate
     

   完成后用原文件夹名称启动项目，即可正常运行。

补充说明 #

MySQL的初始化脚本（如init.sql）仅会在卷第一次创建时执行，后续重建容器不会重复执行。因此如果卷中已有旧数据，哪怕修改初始化脚本也不会生效，必须删除卷才能让MySQL重新初始化权限与数据。

内容的提问来源于stack exchange，提问作者Tobias Feil