生产服务器通过Composer安装Laravel Nova失败如何解决？

API 探路者

2026-10-7

解决步骤

第一步：修复目录权限
第一个报错明确提示目标路径无法创建，本质是Composer运行用户无对应目录读写权限，执行以下命令配置权限（www-data为默认Web运行用户，可替换为你实际部署使用的用户）：
```
sudo chown -R www-data:www-data /var/www/{替换为你的实际项目路径}
sudo chmod -R 755 /var/www/{替换为你的实际项目路径}
```

第二步：校验Composer配置正确性

确认项目根目录composer.json中已正确配置Nova官方仓库源，不要直接指向GitHub的Nova仓库：

"repositories": [
    {
        "type": "composer",
        "url": "https://nova.laravel.com"
    }
]

确认项目根目录或Composer全局目录下的auth.json配置完整，包含Nova许可证校验信息和GitHub Token：

{
    "http-basic": {
        "nova.laravel.com": {
            "username": "你购买Nova时绑定的邮箱",
            "password": "你的Nova许可证密钥"
        }
    },
    "github-oauth": {
        "github.com": "你生成的GitHub Token"
    }
}

第三步：强制Composer优先使用HTTPS拉取包，避免SSH权限问题
执行以下命令调整Composer全局配置，跳过SSH克隆逻辑，直接拉取预编译的dist包：
```
composer config --global preferred-install dist
composer config --global github-protocols https
```
第四步：调整部署命令，服务器端不要执行composer update
本地开发环境执行完composer update后，务必将composer.lock文件一同提交到代码库，服务器部署时仅执行安装命令，避免版本漂移和拉取源异常：
```
composer install --optimize-autoloader --no-dev
```