Composer镜像源不涉及数据库迁移，其作用仅限代理packagist元数据；自动迁移须通过composer.json的post-install-cmd或post-update-cmd脚本实现，需加--force或--no-interaction参数，并确保.env环境变量显式传入。
Composer 镜像源本身不涉及数据库迁移 —— 它只代理 packagist.org 的元数据（packages.json），不托管、不同步、不修改任何数据库结构或内容。 所谓“镜像源同步的数据库迁移”是常见误解，实际要解决的是：在切换镜像源后，如何让项目依赖安装流程与数据库迁移步骤协同工作、不冲突、可复现。
composer install 后自动触发 migrate 的正确写法
很多人想“镜像同步完就自动迁库”，本质是想把依赖安装和数据库变更打包成一个原子操作。这必须靠 composer.json 的 scripts 字段实现，但要注意执行时机和环境隔离：
-
post-install-cmd和post-update-cmd是唯二能确保在vendor/就绪后运行的钩子；post-autoload-dump更早，此时autoload.php可能还没生成，php artisan会报错 - 命令必须带
--force（Laravel）或--no-interaction（Symfony/Doctrine），否则在 CI 或无 TTY 环境直接卡死 - 别用
php artisan migrate简写 —— 必须显式写php artisan migrate --force，否则 Composer 不识别为可执行命令 - Windows 下若 Git Bash 报
command not found: php，改用绝对路径，例如：/c/xampp/php/php.exe artisan migrate --force
镜像切换后 migrate 失败的三大隐藏原因
换源后 composer install 成功，但 php artisan migrate 报错连不上 DB 或找不到类，往往不是数据库问题，而是镜像引发的连锁反应：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.lock中的dist.url仍指向旧源（如https://api.github.com/），说明镜像未真正生效 —— 运行composer clear-cache && rm composer.lock && rm -rf vendor再重装 - 项目含本地 path repository（如
"repositories": [{"type": "path", "url": "../my-package"}]），换源后composer dump-autoload --optimize必须重跑，否则 autoloader 仍引用旧路径 -
post-install-cmd脚本执行时，.env未加载 —— Laravel 默认不读环境变量，需显式传参：APP_ENV=production php artisan migrate --force
为什么不能用 post-autoload-dump 触发 migrate
post-autoload-dump 在 vendor/autoload.php 生成后立即触发，看似合理，但有致命缺陷：
- 它发生在
composer install的中间阶段，此时config/database.php可能还未被框架加载，DB::connection()直接抛出InvalidArgumentException - 如果项目用了
laravel/octane或 Swoole，autoload.php是预热加载的，post-autoload-dump会多次执行，导致迁移被重复调用 - Laravel 的
artisan命令依赖完整的服务容器启动，而post-autoload-dump阶段容器根本没初始化 —— 此时执行php artisan migrate实际上会 fallback 到原始 PHP CLI 模式，跳过所有框架中间件和配置
最易被忽略的一点：镜像源切换和数据库迁移是两个正交问题。镜像只影响 composer install 的下载速度与可复现性；迁移是否成功，取决于 APP_ENV、.env 加载顺序、DB 用户权限、以及 post-install-cmd 是否真的在 vendor 就绪后才执行 —— 这三者缺一不可。
