“Input/output error”是磁盘IO故障信号，源于文件系统或存储设备异常，常见于NFS挂载、SSD损坏、磁盘满载/只读、Docker卷权限问题等场景。
Composer install/update 报错 “Input/output error” 是磁盘 IO 故障信号
这个错误不是 Composer 本身的问题，而是底层文件系统或存储设备已无法正常读写。常见于挂载的 NFS、损坏的 SSD、满载或只读的磁盘、Docker volume 权限异常等场景。一旦出现 Input/output error，Composer 通常会在解压 zip 包、写入 vendor/ 或读取 composer.lock 时中断，且错误不可重试掩盖。
快速定位是否为真实磁盘 IO 问题
别急着重装 Composer 或清缓存，先验证系统级读写能力：
- 运行
df -h检查磁盘使用率 —— 若/或/home（或项目所在分区）显示100%，Input/output error很可能由空间耗尽引发 - 执行
touch /tmp/composer-test && rm /tmp/composer-test—— 若也报错Input/output error，说明问题在根文件系统层 - 检查
dmesg | tail -20—— 出现end_request: I/O error、ataX.Y failed command: READ或NFS: server not responding等日志，即确认是硬件/NFS 层故障 - 若项目在 Docker 中，进入容器后运行
mount | grep $(pwd)，确认挂载类型和选项（如ro只读或nfs异常）
常见诱因与对应修复动作
不同场景下，解决路径差异很大，不能一概而论：
-
NFS 挂载不稳定：升级 NFS 客户端参数，如挂载时加
hard,intr,rsize=65536,wsize=65536,timeo=14,retrans=3；避免在 NFS 上直接运行composer install，改用本地构建再 rsync 同步 -
Docker volume 权限/挂载方式错误：确保宿主机目录有写权限（
chmod -R a+w /path/to/project），优先用 named volume 而非 bind mount；若必须 bind mount，启动容器时加--user $(id -u):$(id -g) -
磁盘坏道或 SSD 寿命告竭：运行
sudo smartctl -a /dev/sdX（替换为实际设备）查看Reallocated_Sector_Ct和Media_Wearout_Indicator；对服务器应立即停用并更换硬盘 -
Linux tmpfs /dev/shm 满载：Composer 解压 zip 时可能临时使用
/dev/shm，执行df -h /dev/shm，若 100%，可临时扩容：sudo mount -o remount,size=2G /dev/shm
绕过 IO 错误的临时应急操作（慎用）
仅限调试或紧急交付，不解决根本问题，且可能掩盖更严重隐患：
- 禁用 Composer 的 zip 解压优化（强制用 PHP 流）：
COMPOSER_DISABLE_ZIP=true composer install - 跳过 vendor 目录写入校验（风险高）：
composer install --no-scripts --no-plugins，但后续脚本执行仍可能失败 - 改用离线模式：提前在健康机器上
composer install --no-dev打包整个vendor/，再 scp 到目标机 —— 注意 PHP 版本和扩展兼容性
真正稳定的方案永远是让磁盘回归可读写状态。IO 错误不会自己消失，反复重试只会加速设备失效。
