thinkphp自动化部署核心在于构建不污染、部署不中断、迁移不丢数据三关；需严格区分构建机与服务器执行步骤，禁用dev依赖、显式指定php版本、排除runtime等目录、强制备份后人工确认迁移，并确保权限、环境变量及调试开关正确配置。
ThinkPHP自动化部署不是配个脚本就完事，核心在于构建阶段不污染生产环境、部署阶段不中断服务、迁移阶段不丢数据——这三关卡住，再好的CI/CD也会在上线时翻车。
Git触发后，composer install 为什么总报错或超时？
常见错误是本地开发装了 --dev 依赖，但生产环境没清理干净，或者镜像源没切到国内。更隐蔽的问题是：Gitee/GitHub Actions 的 runner 默认用的是系统级 PHP，和你服务器上实际运行的 PHP 版本不一致（比如 runner 是 PHP 8.0，服务器是 PHP 8.1），导致 opcache 或扩展加载失败。
- 必须加
--no-dev --optimize-autoloader，否则vendor/autoload.php会包含大量测试类，影响性能且可能触发禁用函数（如exec）报错 - 在 CI 配置里显式指定 PHP 版本，例如 Gitee 流水线中写
phpVersion: '8.1'，避免隐式继承 runner 默认版本 - 提前在服务器上配置 Composer 全局镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，CI 阶段也建议加这行命令，防止因网络波动拉包失败
部署脚本里 git reset --hard origin/main 安全吗？
不安全，除非你确认服务器上的 Git 仓库只用于部署、不参与日常开发。直接 reset --hard 会丢掉所有未提交的改动（比如手动改过的 .env、runtime/ 日志、临时上传文件），而且无法回退。
- 推荐用「软切换」方式：先
git fetch拉新代码，再用git checkout -f $(git rev-parse origin/main)强制检出，不重置工作区历史 -
runtime/和public/uploads/这类目录必须从部署流程中排除，用rsync --exclude或在.gitignore里明确忽略，不能靠git clean - 如果用了多应用（如
app/admin/），确保git操作前已cd到项目根目录，否则git remote add origin可能建在子目录下，后续拉不到主分支
数据库迁移怎么避免线上挂掉？
ThinkPHP 的 php think migrate:run 默认直连生产库执行，一旦迁移语句有误（比如删字段没加判断），服务瞬间不可用。这不是“能不能跑”的问题，是“敢不敢让它跑”的问题。
- 迁移命令必须加
--force参数，否则在非交互环境下会卡住等待确认 - 迁移前先做备份：在部署脚本里加
mysqldump -u $DB_USER -p$DB_PASS $DB_NAME > /backup/$(date +%s).sql，并确保/backup目录有写权限 - 关键迁移（如结构变更）应拆成两步：先在预发环境验证，再用
php think migrate:status检查线上当前版本，人工确认无误后再执行run - 绝不允许在 CI 构建阶段执行迁移——构建机没有生产数据库访问权限，也不该有
为什么部署后页面空白或 500 错误？
绝大多数情况不是代码问题，而是权限或运行模式没切对。ThinkPHP 8 在生产环境对 runtime/ 目录写权限、.env 文件存在性、app_debug 开关极其敏感。
-
chown -R www:www /var/www/thinkphp8必须执行，且要确认 Web 服务（Nginx/Apache）运行用户确实是www，CentOS 7 默认可能是apache或nginx -
chmod -R 775 runtime/是底线，644不够，755也不行；但config/和.env必须是644，否则框架拒绝读取 - 检查
.env是否真实存在、是否被git忽略、是否在部署后被覆盖；建议把.env.production放进仓库，部署脚本里用cp .env.production .env替换 -
app_debug=false和app_mode=production必须同时生效，只设一个没用
真正难的不是写对一行 git pull，而是搞清哪一步该在构建机跑、哪一步必须在目标服务器跑、哪一步根本不能自动——比如数据库迁移的最终确认，永远不该交给机器决定。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
