线上自动部署失败主因是post-receive钩子中PHP等命令未用绝对路径导致找不到，且git用户环境变量缺失、权限不足、错误未捕获、opcache未清理。
git hook 里没用绝对路径，脚本根本找不到 PHP
线上自动部署失败，八成是 post-receive 钩子里调用的 php 命令压根没执行——因为钩子运行在非交互式 shell 下，$PATH 和你本地终端完全不一样，php 命令大概率不在默认搜索路径里。
- 用
which php在服务器上查真实路径，比如/usr/bin/php或/opt/remi/php82/root/usr/bin/php - 钩子里所有命令都写绝对路径：
/usr/bin/php /var/www/deploy.php，别写php deploy.php - 别依赖
~或./：钩子工作目录不固定，要用完整路径，比如/var/repo/site.git/hooks/post-receive
PHP 脚本被 git 用户执行，权限和环境变量全不对
git 推送触发的是 git 用户（或你配的部署用户）跑的钩子，这个用户通常没家目录、没 .bashrc、没 Composer 全局 bin 路径，连 vendor/autoload.php 都 require 不进去。
- 在 PHP 脚本开头加
putenv('HOME=/var/www')或显式设置关键环境变量 - 不要用
exec('composer install')—— 换成exec('/usr/bin/composer --no-interaction install')，并确认该用户对vendor/目录有读写权 - 检查 Web 目录属主：如果 PHP 脚本把文件解到
/var/www/html，得确保git用户能写，且 Web 服务用户（如www-data）能读
post-receive 钩子里没捕获错误，失败了也静默
钩子脚本里任何命令出错，默认不会中断，也不会报给推送方，看起来“成功”了，其实 git pull 卡在权限拒绝、composer 报错、甚至 php 解析失败都没人知道。
- 每条关键命令后加判断：
if [ $? -ne 0 ]; then echo "pull failed" >&2; exit 1; fi - PHP 脚本里打开错误报告：
error_reporting(E_ALL); ini_set('display_errors', '0'); ini_set('log_errors', '1');，日志写到明确路径，比如/var/log/deploy.log - 推送时加
-v看详细输出：git push -v origin main，注意看远程返回的 stderr 内容
Web 服务器缓存或 opcache 导致新代码不生效
部署脚本明明跑完了，浏览器还是旧页面——不是钩子错了，是 PHP opcache 没清，或者 Nginx 缓存了 index.html 的响应头。
立即学习“PHP免费学习笔记（深入）”；
- 部署完强制清除 opcache：
opcache_reset()（需在 CLI 模式下可用）或重启 php-fpm：systemctl restart php8.2-fpm - 检查 Nginx 是否开了
fastcgi_cache，临时关掉测试；或者确保响应头没带Cache-Control: public, max-age=3600 - 上线前加个时间戳验证：
file_put_contents('/var/www/html/deployed_at', date('c'));，浏览器直接请求这个文件看是否更新
