生产环境Docker部署Laravel时非root用户下.env文件读取异常问题咨询

方案1：生产环境使用配置缓存（最优推荐） #

这是Laravel官方推荐的生产环境部署方案，完全规避.env文件的依赖：

• 实现原理：执行php artisan config:cache命令后，Laravel会将所有配置（包括注入的系统环境变量）打包为静态缓存文件存储在bootstrap/cache目录下，后续运行时会完全跳过.env文件的读取逻辑，直接读取缓存。
• 操作步骤：
  1. 在Dockerfile构建阶段，提前给缓存和存储目录授予1001用户的读写权限，最后切换到1001用户：

  # 省略基础镜像、代码复制等前置步骤
  RUN chown -R 1001:1001 bootstrap/cache storage
  USER 1001
  ENTRYPOINT ["/bin/sh", "start.sh"]
  

  2. 编写容器启动脚本start.sh，在所有环境变量注入完成后先生成配置缓存，再启动应用：

  #!/bin/sh
  php artisan config:cache
  # 替换为你实际的应用启动命令，例如php-fpm、octane:start等
  php-fpm
  

  3. 直接删除镜像内的.env文件，无需保留任何相关配置。
• 注意事项：
  • 使用配置缓存后，不要在config目录以外的代码中调用env()函数，否则会返回null，所有环境变量读取统一通过config()函数实现。
  • 容器重启或版本更新时，启动脚本会自动读取最新注入的环境变量重新生成缓存，不会出现配置丢失问题。

方案2：强制禁用.env文件加载（无需缓存场景） #

如果你的业务场景不适合使用配置缓存，可以直接修改Laravel的加载逻辑，强制跳过.env文件读取：

• 操作步骤：打开项目根目录下的bootstrap/app.php文件，在返回Application实例前，添加一行代码指定.env文件查找路径为无效地址：

<?php
// 省略原有代码
$app = new Illuminate\Foundation\Application(
    $_ENV['APP_BASE_PATH'] ?? dirname(__DIR__)
);

// 新增这一行，禁用.env加载
$app->useEnvironmentPath('/dev/null');

// 省略后续返回$app的代码

• 实现原理：Laravel找不到.env文件时，会自动降级读取系统级别的环境变量，原生env()函数无需修改即可正常获取注入的配置。

之前尝试的方案失效原因：

1. 只要存在非空/空的.env文件，Laravel都会优先读取文件内的配置值，覆盖同名系统环境变量；
2. 全局替换env()为getenv()改造成本高，容易出现遗漏；
3. 外部挂载.env文件崩溃通常是因为1001用户没有挂载文件的读取权限，且挂载敏感文件本身不符合容器安全规范。

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