使用Laravel Sail安装含私有包的现有Laravel应用遇阻求助

1. 先解决Composer缓存目录权限问题 #

你遇到的fatal: could not create leading directories of '/.composer/cache/...'报错，核心原因是：

• 命令里用-u "$(id -u):$(id -g)"指定了非root用户运行容器，但容器根目录下的/.composer属于root权限，当前用户没有读写权限，自然创建不了缓存目录。

快速修复方案：指定缓存目录到项目内 #

修改命令，添加环境变量把Composer缓存放到项目目录下（当前用户肯定有权限）：

# 先在项目根目录创建缓存目录并授权
mkdir .composer-cache && chown $(id -u):$(id -g) .composer-cache

# 执行带缓存目录配置的安装命令
docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    -e COMPOSER_CACHE_DIR="/var/www/html/.composer-cache" \
    laravelsail/php81-composer:latest \
    composer install --ignore-platform-reqs

2. 修正SSH密钥的挂载逻辑 #

你之前挂载密钥到/home/sail/.ssh是错的——因为你指定了-u "$(id -u):$(id -g)"，容器里运行的不是sail用户，而是你本地的UID/GID对应用户，这个用户的家目录不是/home/sail，自然读不到密钥。

推荐方案：用本地SSH Agent转发（安全又省心） #

不用挂载密钥文件，直接共享本地的ssh-agent，让容器用你本地已加载的密钥：

# 先确保本地ssh-agent加载了你的密钥
ssh-add /path/to/.ssh/id_rsa

# 执行安装命令
docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -v $SSH_AUTH_SOCK:/ssh-agent \
    -e SSH_AUTH_SOCK=/ssh-agent \
    -e COMPOSER_CACHE_DIR="/var/www/html/.composer-cache" \
    -w /var/www/html \
    laravelsail/php81-composer:latest \
    composer install --ignore-platform-reqs

备选方案：直接挂载密钥到当前用户目录 #

如果不想用agent转发，就把密钥挂载到容器内当前用户的.ssh目录，同时强制设置密钥权限（SSH要求密钥必须是600权限）：

# 先把Bitbucket的主机指纹加到本地known_hosts，避免容器内连接时需要确认
ssh-keyscan bitbucket.org >> /path/to/.ssh/known_hosts

# 执行安装命令
docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -v "/path/to/.ssh:/home/$(id -u)/.ssh" \
    -e COMPOSER_CACHE_DIR="/var/www/html/.composer-cache" \
    -w /var/www/html \
    laravelsail/php81-composer:latest \
    bash -c "chmod 600 /home/$(id -u)/.ssh/id_rsa && composer install --ignore-platform-reqs"

3. 为什么队友用sail composer能正常工作？ #

sail composer是在Laravel Sail预配置的容器里执行的：

• 容器默认用sail用户，已经配好~/.ssh目录的权限
• Composer缓存路径已经设置到用户有权限的位置
• 可能自动挂载了本地SSH密钥或agent

嫌折腾的话，直接用Sail的命令更简单：

# 先启动Sail容器（如果没启动的话）
bash ./vendor/bin/sail up -d

# 执行依赖安装
sail composer install --ignore-platform-reqs

内容的提问来源于stack exchange，提问作者TJ is too short