composer 的几条报错看起来都像「文件坏了」,其实成因分布在三个完全不同的层面:当前路径、文件编码、文件属主。分开排查比反复重装更快。

找不到 composer.json
报 "Could not open input file: composer.json" 时,Composer 不会替你向上查找文件,只认当前工作目录。执行前先做两步:用 pwd 确认位置,再用 ls -l composer.json 确认文件真实存在且可读。如果项目目录是软链接或挂载进 Docker,composer.json 可能被 realpath() 忽略,此时改用 composer -d /absolute/path/to/project install;-d 必须放在子命令之前,路径是含 composer.json 的目录,不能是文件路径。若曾用 Windows 记事本保存过 composer.json,用 file -i 检查是否含 BOM,输出带 bom 就另存为纯 UTF-8。
写入被拒与属主残留
另一种常见报错是 file_put_contents(.../vendor/autoload.php) 失败。看报错里的完整路径,执行 ls -ld 对应目录;若属主显示 root root,多半是以前用 sudo composer install 留下的,后续普通用户命令自然被拒。修复要用 chown 而不是 chmod:sudo chown -R $USER:$USER vendor/ composer.lock,全局缓存同样处理(可用 composer config --global cache-dir 取路径)。Docker 场景要注意 UID 匹配,宿主机 1000、容器 root 时,改成 sudo chown -R 1000:1000 vendor/。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。

顺带区分一条长得像网络问题的报错:"Your requirements could not be resolved" 不是拉包失败,元数据已经拉完,卡在 SAT 求解阶段,说明你写的版本约束之间没有交集。命令示例按 Linux/macOS 习惯给出,Windows 与容器环境需按实际用户与路径调整。










