Composer在NFS上安装依赖易失败，主因是NFS不支持flock()，而Composer依赖文件锁；解决方法包括：设COMPOSER_DISABLE_FLOCK=1禁用锁检查、优化NFS挂载参数（如noac、nolock）、将vendor目录移至本地磁盘、分阶段执行install与dump-autoload。
Composer在NFS挂载的文件系统上安装依赖时容易失败，核心原因是NFS默认不支持flock()等文件锁机制，而Composer在解压、写入vendor目录、生成autoload文件等环节高度依赖可靠的文件锁定。解决的关键是绕过或模拟锁行为，同时确保NFS挂载配置合理。
禁用Composer的文件锁检查
最直接有效的方式是让Composer跳过锁校验。通过设置环境变量或配置项，关闭其内部对flock的支持：
- 运行命令前临时禁用：COMPOSER_DISABLE_FLOCK=1 composer install
- 全局配置（影响所有项目）：composer config -g disable-tls true 不适用；正确做法是：composer config -g discard-changes true 并配合环境变量使用
- 更稳妥的组合：在CI/部署脚本中统一加 COMPOSER_DISABLE_FLOCK=1 COMPOSER_CACHE_DIR=/tmp/composer-cache composer install --no-interaction
优化NFS挂载参数
NFS客户端挂载选项能显著改善并发写入和元数据一致性问题：
- 添加 noac（关闭属性缓存）或 actimeo=1（缩短属性缓存时间），避免stat结果过期导致的“文件已存在”误判
- 使用 nolock（禁用NFS锁协议），与COMPOSER_DISABLE_FLOCK=1协同生效
- 推荐挂载示例：mount -t nfs -o rw,hard,intr,noac,nolock,proto=tcp,timeo=600,retrans=2 server:/path /mnt/project
将vendor目录移出NFS
根本性规避问题：把需要频繁读写的vendor目录放在本地磁盘，仅保留源码在NFS上：
- 在composer.json中配置："config": {"vendor-dir": "/var/local/myapp/vendor"}
- 确保目标路径有写权限且不在NFS上（如/var/local挂载为ext4）
- 搭配COMPOSER_VENDOR_DIR环境变量使用更灵活，适合多环境部署
使用--no-scripts和分阶段执行
某些失败发生在post-install-cmd脚本中（如生成autoload、清理缓存），这些操作常触发额外文件锁：
- 先运行：COMPOSER_DISABLE_FLOCK=1 composer install --no-scripts --no-autoloader
- 再单独执行 autoload 生成：composer dump-autoload --optimize（此时vendor已就位，冲突概率低）
- 最后手动触发必要脚本，便于定位具体哪一步出错
