Symfony部署异常：composer install --no-dev返回错误码255求助

你遇到的是prod环境下缓存清理脚本执行失败的问题，而dev环境下正常，这通常和prod环境配置、权限或者依赖缺失有关。这里有几个可行的解决步骤：

1. 先手动清理prod缓存再执行安装 #

有时候缓存目录里残留的dev环境数据会干扰prod缓存清理，先手动清理再跑安装命令试试：

# 先清理prod缓存，不预热（避免提前触发错误）
php bin/console cache:clear --env=prod --no-warmup
# 再执行带--no-dev的安装
composer install --no-dev

2. 检查并修复文件权限 #

Symfony的var/cache和var/log目录需要当前命令行用户和web服务器用户的读写权限，权限不足会直接导致缓存清理失败。你可以用以下命令设置安全的权限：

# 替换www-data为你的web服务器用户组（比如apache/httpd）
chown -R www-data:www-data var/cache var/log
chmod -R 775 var/cache var/log

如果是本地测试环境，也可以临时用chmod -R 777 var/cache var/log快速验证是否是权限问题，但生产环境不推荐这么做。

3. 分步执行安装，跳过自动脚本定位问题 #

把安装和脚本执行分开，能更精准定位具体是哪一步出错：

# 先安装依赖，跳过所有自动脚本
composer install --no-dev --no-scripts
# 手动执行prod缓存清理
php bin/console cache:clear --env=prod
# 再执行post-install的脚本
composer run-script --no-dev post-install-cmd

如果手动清理缓存时出现具体错误信息，就能直接找到问题根源（比如某个配置引用了dev环境的bundle，或者缺失核心依赖）。

4. 检查prod环境配置是否依赖dev包 #

打开config/packages/prod/下的配置文件，确认没有引用只在dev环境安装的bundle或服务。比如web_profiler这类调试用bundle只应该在dev/test环境启用，如果prod配置里不小心启用了，就会因为缺少依赖导致缓存清理失败。

5. 检查composer依赖是否有prod缺失的包 #

查看composer.json的require-dev部分，确认prod环境的代码没有间接依赖这些包。比如某个prod环境需要的服务，它的依赖包被误放在了require-dev里，这样--no-dev安装时就会缺失，进而触发缓存清理报错。

内容的提问来源于stack exchange，提问作者Eres