crontab里执行composer命令失败，90%因path未包含其bin目录或php路径；需在crontab顶部显式定义path、shell和home，或用绝对路径调用php和composer，避免依赖shell配置文件。
crontab 里跑 composer 命令失败，90% 是因为 PATH 没包含 ~/.composer/vendor/bin 或 PHP 路径 —— 不是 composer 没装，是 crontab 根本找不到它。
为什么 crontab 找不到 composer 命令
crontab 默认只用极简环境：PATH=/usr/bin:/bin，完全不读 ~/.bashrc 或 ~/.zshrc。即使你在终端里能直接敲 composer，在 crontab 里它就是“command not found”。更隐蔽的是：即使 composer 找到了，它全局安装的命令（如 laravel、phpunit）也大概率因 PATH 缺失而失效。
- 现象：手动运行
composer install正常，但0 3 * * * cd /var/www/app && composer install报错/bin/sh: composer: not found - 根本原因：crontab 的
PATH里没有composer可执行文件所在目录（通常是~/.composer/vendor/bin或~/.config/composer/vendor/bin） - 连带问题：PHP 解释器路径也可能缺失，比如
php命令找不到，导致composer.phar无法执行
在 crontab 文件顶部显式定义 PATH 和 SHELL
这是最稳定、可复用的方案，所有后续任务都继承该环境。
- 运行
crontab -e，在第一行（任何任务之前）添加： -
PATH=/usr/local/bin:/usr/bin:/bin:/home/youruser/.config/composer/vendor/bin:/opt/php/bin（把youruser替换为实际用户名；路径用composer global config bin-dir --absolute确认） -
SHELL=/bin/bash（避免某些系统默认用/bin/sh，不兼容 bash 特性） -
HOME=/home/youruser（确保~展开和配置文件路径正确） - 注意：
=两侧不能有空格；不要写$PATH；变量名不加$
单条任务补救：用 env 或绝对路径硬指定
适合临时修复或不想改全局配置的场景，但每条任务都要重复写，维护成本高。
- 方式一：用
env传入PATH：0 3 * * * env PATH="/usr/bin:/bin:/home/youruser/.config/composer/vendor/bin" cd /var/www/app && composer install >> /tmp/composer.log 2>&1 - 方式二：全部用绝对路径（最保险）：
0 3 * * * cd /var/www/app && /usr/bin/php /home/youruser/.local/bin/composer install >> /tmp/composer.log 2>&1
其中/usr/bin/php来自which php，/home/youruser/.local/bin/composer来自which composer或你手动移动composer.phar的位置 - 切记：不要写
composer install，必须写全路径调用解释器或可执行文件
验证 PATH 是否生效并定位真实缺失项
别猜，直接看 crontab 实际运行时的环境。
- 加一条测试任务：
* * * * * env > /tmp/cron_env.txt 2>&1 - 等 1–2 分钟，运行
cat /tmp/cron_env.txt | grep PATH，确认输出中是否含你的composerbin 目录 - 再手动对比：
在终端运行env | grep PATH（你的交互式环境）
和/tmp/cron_env.txt（crontab 环境）—— 差异就是你要补的路径 - 如果
composer还报错，但PATH已对，就检查php是否在该PATH中，或是否需要显式指定PHP_BINARY（尤其当php不在标准路径时）
真正容易被忽略的点是：Composer 全局 bin 目录路径在 Composer 2.4+ 默认变为 ~/.config/composer/vendor/bin，不是旧版的 ~/.composer/vendor/bin；且这个路径必须是绝对路径，不能含 ~，也不能依赖 $HOME 变量展开 —— crontab 不做这种解析。
