composer 报 “invalid project root directory” 是因当前目录无合法 composer.json：文件必须存在、非空、json 语法正确、含有效 name 和 require 字段，且当前用户有读权限。
为什么 composer install 报 “Invalid project root directory”？
这个错误不是 Composer 自身故障，而是它在找 composer.json 时失败了——它要求当前工作目录下必须存在合法的 composer.json 文件，且该文件不能是空的、不能语法错误、也不能被权限锁死。
常见真实场景：
- 你在项目子目录（比如
src/或public/）里执行了composer install -
composer.json被误删或重命名成composer.json.bak - 文件存在但内容为空，或只有
{}而没声明name和require - 当前用户对
composer.json没有读权限（ls -l composer.json显示----------或属主不匹配）
确认并切换到真正的项目根目录
Composer 的“项目根目录”定义很机械：就是那个含有 composer.json 的最上层目录。别猜，用命令定位：
- 运行
find . -name "composer.json" -type f | head -1，看输出路径，然后cd进去 - 如果项目是从 Git 克隆的，通常根目录就是
git rev-parse --show-toplevel返回的路径 - 用
ls -la确认当前目录下确实有composer.json，且大小 > 0 字节
composer.json 文件本身是否合格？
即使文件存在，Composer 也会在解析阶段校验基本结构。一个最小可用的 composer.json 至少要包含：
{
"name": "myapp/example",
"require": {}
}
注意以下硬性规则：
-
name字段必须存在，格式为vendor/name（两个单词，用斜杠分隔） - 不能用中文、空格或特殊符号在
name或description中 - JSON 语法必须严格正确：末尾不能多逗号，字符串必须双引号，布尔值不能写成
true以外的形式 - 若你从别人那里拿到项目，检查是否有
composer.json被 Git LFS 或 .gitattributes 错误过滤
共享主机或容器中容易被忽略的权限陷阱
有些环境会静默阻止 Composer 读取 composer.json，表现为“找不到文件”或直接报无效根目录，实际是权限卡住：
- 运行
getfacl composer.json 2>/dev/null || ls -l composer.json，确认当前用户有r权限 - 如果项目放在
~/public_html/下，某些主机（如 cPanel）默认禁用该目录下脚本读取敏感配置文件，需改放到~/myapp/再用 Web 服务器 alias 暴露 - Docker 容器中挂载卷时用了
:ro或uid/gid不匹配，导致文件存在但不可读
最简验证法：在当前目录运行 php -r "echo json_encode(json_decode(file_get_contents('composer.json'), true));"，如果报错或输出空，说明 Composer 启动前就读取失败了——先解决这个，再跑 install。
