Laravel生成应用密钥时无法检测.env文件问题求助

问题场景 #

在Docker环境部署Laravel项目，执行php artisan key:generate时收到错误：

Unable to set application key. No APP_KEY variable was found in the .env file.

但宿主机目录下存在.env文件且已配置APP_KEY，目录列表及.env内容如下：

root@..:/var/www/html# ls -la
total 556
drwxrwxrwt 14 www-data www-data   4096 Sep  1 14:51 .
drwxr-xr-x  1 root     root       4096 Aug 16 02:12 ..
-rw-r--r--  1 www-data www-data    258 Sep  1 14:47 .editorconfig
-rw-r--r--  1 www-data www-data   1972 Sep  1 14:51 .env
-rw-r--r--  1 www-data www-data    821 Sep  1 14:47 .env.example

.env内容：

APP_ENV=local
APP_KEY=base64:****************************
APP_DEBUG=true

解决步骤 #

1. 验证容器内是否存在.env文件 #

Docker容器和宿主机的目录挂载可能配置错误，导致容器内无法读取到宿主机的.env：

# 进入运行中的Laravel容器
docker exec -it [容器ID/容器名称] bash
# 切换到项目根目录
cd /var/www/html
# 查看文件列表
ls -la

如果容器内没有.env文件，需修正docker-compose.yml或docker run命令中的volume配置，确保宿主机的/var/www/html目录正确挂载到容器内的对应项目目录。

2. 检查容器内.env的权限与内容 #

容器内的.env文件需要保证Laravel进程（通常为www-data用户）有读取权限：

# 设置文件所属用户组
chown www-data:www-data .env
# 设置文件权限为可读
chmod 644 .env

同时检查容器内.env的实际内容，确保APP_KEY行无多余空格或特殊字符：

cat .env

若内容与宿主机不一致，重启容器同步挂载内容：

docker restart [容器ID/容器名称]

3. 清除Laravel配置缓存 #

Laravel可能已缓存旧配置，导致未读取最新的.env内容：

# 清除配置缓存
php artisan config:clear
# 清除应用缓存
php artisan cache:clear

之后可尝试重新生成密钥（如需覆盖现有密钥，添加--force参数）：

php artisan key:generate
# 或强制覆盖现有密钥
php artisan key:generate --force

也可通过tinker验证APP_KEY是否加载成功：

php artisan tinker
echo env('APP_KEY')

4. 检查Docker镜像启动逻辑 #

部分自定义Laravel镜像会在启动时自动复制.env.example为.env，覆盖挂载的.env文件。需检查Dockerfile或启动脚本，移除自动生成.env的逻辑，例如删除类似以下的命令：

cp .env.example .env

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