在Dockerfile中执行php artisan migrate报错的问题求助

核心问题基本是Docker容器与数据库服务的网络连通性或配置匹配出错，以下是针对性排查和解决步骤：

1. 核对数据库连接配置 #

确保Laravel项目.env文件的数据库配置和你的MySQL服务完全匹配：

DB_CONNECTION=mysql
DB_HOST=mysql  # Docker Compose部署的MySQL填服务名；本地MySQL填host.docker.internal（Windows/Mac）或宿主机局域网IP（Linux）
DB_PORT=3306
DB_DATABASE=你的目标数据库名
DB_USERNAME=数据库用户名
DB_PASSWORD=数据库密码

注意：容器内的localhost指向容器自身，不能用来连接宿主机或其他容器的MySQL。

2. 确保MySQL服务完全就绪 #

Docker启动的MySQL需要时间完成初始化，直接在Dockerfile里执行RUN php artisan migrate大概率因为数据库未就绪失败，正确做法：

• 不要在Dockerfile中直接写迁移命令，改用启动脚本或容器启动后手动执行
• 用Docker Compose的话，添加健康检查确保MySQL就绪后再启动Laravel容器：

services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: laravel_db
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      timeout: 20s
      retries: 10
  app:
    build: .
    depends_on:
      mysql:
        condition: service_healthy

3. 验证容器与数据库的连通性 #

进入Laravel容器，测试和数据库的连通性：

# 进入容器
docker exec -it 你的容器名 sh
# 测试Docker Compose中MySQL的端口连通
telnet mysql 3306
# 测试本地MySQL的端口连通
telnet host.docker.internal 3306

如果不通，排查这几点：

• MySQL服务是否真的启动（Docker用docker ps查看状态，本地检查系统服务）
• 宿主机防火墙/安全组是否开放3306端口
• MySQL是否允许外部连接：修改my.cnf的bind-address为0.0.0.0，并授权远程访问：

GRANT ALL ON *.* TO '用户名'@'%' IDENTIFIED BY '密码';
FLUSH PRIVILEGES;

4. 手动执行迁移 #

等容器和数据库都就绪后，手动进入容器执行迁移：

docker exec -it 你的容器名 php artisan migrate

如果仍报错，根据具体提示处理：

• 数据库不存在：提前用MySQL命令创建，或通过Docker MySQL的MYSQL_DATABASE环境变量自动初始化
• 权限不足：确保.env中的数据库用户有创建表的权限

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