Laravel现有项目执行composer install报错：Expected name to be a non-empty string

DevOps 小满

2026-7-22

解决Composer执行命令时出现"Expected name to be a non-empty string"错误的方法

排查与修复步骤

检查全局Composer配置
打开对应系统的全局配置文件：
- Linux/macOS：~/.composer/config.json
- Windows：C:\Users\{你的用户名}\AppData\Roaming\Composer\config.json
  确认repositories字段下的所有仓库配置都有非空的name值，若存在"name": ""的条目，删除该条目或补全有效的仓库名称。
清理Composer缓存
执行以下命令清除缓存，避免缓存损坏导致的解析错误：
```
composer clear-cache
```
清理完成后再次尝试执行composer install。
检查项目本地composer.json
打开项目根目录的composer.json文件，查看repositories部分，确保所有仓库配置的name字段不为空。示例正确配置：
```
"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/example/package.git",
        "name": "example/package"
    }
]
```
修正无效配置后保存文件，重新执行Composer命令。
重新安装Composer
若以上方法均无效，直接重新安装最新版Composer：
- Linux/macOS：
```
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
```
- Windows：下载Composer安装包运行覆盖安装。