Docker Stack部署Laravel：php artisan migrate:fresh执行位置咨询

我来帮你梳理几种可行的方案，解决在Docker Stack部署Laravel时执行php artisan migrate:fresh的问题：

可以给Laravel容器加个启动脚本，让它启动时先处理数据库迁移，再启动服务，还能避免因MySQL未就绪导致的连接失败问题：

• 先在项目根目录创建start.sh脚本：

#!/bin/sh
# 等待MySQL服务完全就绪
until php artisan db:check; do
    echo "等着MySQL服务起来..."
    sleep 2
done
# 执行重置式迁移
php artisan migrate:fresh
# 启动你的Laravel服务（比如php-fpm，根据你的实际配置调整）
exec "$@"

• 然后修改Dockerfile，把脚本加进去：

COPY start.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/start.sh
# 如果你原本是用php-fpm启动，就改成下面这样
CMD ["start.sh", "php-fpm"]

这样每次容器启动都会自动完成迁移操作，适合开发环境快速重置数据库。

如果只是偶尔需要重置数据库，可以直接进入已经运行的Laravel容器执行命令：

• 先找到你的Laravel容器ID：

docker ps

• 进入容器的终端：

docker exec -it <你的容器ID> bash

• 在容器内直接执行迁移命令：

php artisan migrate:fresh

这种方式灵活，适合临时调试或一次性操作。

你之前试过在docker-compose里设置command，但大概率是没处理好MySQL的就绪等待。可以这样配置：

services:
  app:
    build: .
    command: >
      sh -c "until php artisan db:check; do sleep 2; done; php artisan migrate:fresh; php-fpm"
    depends_on:
      - db
    # 其他配置...
  db:
    image: mysql:8.0
    # 你的数据库配置...

这里用sh -c把命令串起来，先等MySQL就绪，再执行迁移，最后启动服务。注意depends_on只是保证启动顺序，不保证数据库服务完全可用，所以等待脚本是必要的。

既然你之前在Jenkins里执行这个命令，完全可以把这个环节集成到部署流水线里：

• 在Jenkins部署完成Docker Stack后，用docker exec（单节点）或docker service exec（Swarm集群）远程执行迁移：

# 单节点环境
docker exec -it $(docker ps -q -f name=<你的应用服务名>) php artisan migrate:fresh --force
# Swarm集群环境
docker service exec <你的应用服务名> php artisan migrate:fresh --force

这种方式适合生产环境，因为迁移只会执行一次，不会每次容器重启都重置数据库，加上--force参数可以跳过交互确认。

重要提醒 #

migrate:fresh会删除所有现有表并重新创建，生产环境一定要谨慎使用！如果是生产环境，建议用php artisan migrate（只执行未完成的迁移），而非重置式的migrate:fresh。另外要确保Laravel的.env文件里，数据库地址配置的是Docker Stack里的MySQL服务名（比如DB_HOST=db）。

内容的提问来源于stack exchange，提问作者Tara Prasad Gurung