Laravel10/Filament3自定义插件安装失败及Composer配置问题

1. Composer JSON Schema 格式错误修复 #

报错提示repositories.type和repositories.url应为对象而非字符串，是因为composer.json中的repositories配置不符合规范。

• 错误示例（字符串或非数组对象）：

"repositories": "https://github.com/your/plugin"

• 正确配置（对象数组）：

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/your/custom-plugin"
    }
]

执行composer validate可快速定位错误位置，修正后再运行composer update。

2. Laravel Installer 命令未找到修复 #

安装成功但laravel -V无响应，是因为全局二进制文件路径未加入系统PATH：

• 查看Composer全局bin目录：composer global config bin-dir --absolute
• 编辑shell配置文件（如~/.bashrc或~/.zshrc），添加：

export PATH="$HOME/.config/composer/vendor/bin:$PATH"

• 刷新配置：source ~/.bashrc（对应你的shell配置文件），之后即可正常使用laravel命令。

3. PATH添加后JSON Schema错误仍存在 #

该错误与PATH无关，依旧是composer.json的repositories格式问题：

• 确保repositories是数组类型，每个元素为包含type和url的对象
• 避免将repositories设为字符串或单个非数组对象
• 修正后执行composer validate验证，无错误再执行composer update。

4. 更新Composer后JSON Schema错误依旧 #

更新Composer仅解决废弃警告，JSON Schema错误是本地配置文件问题，需按以下步骤处理：

1. 备份当前composer.json文件
2. 严格按照Composer官方规范配置repositories字段
3. 执行composer validate --strict进行严格检查，根据提示修正所有格式问题
4. 最后运行composer update完成自定义插件安装。

内容的提问来源于stack exchange，提问作者mstdmstd