Laravel项目中ENV变量无法访问（null）的故障排查求助

在浏览器访问Laravel应用时，出现.env变量无法访问（返回null）的错误：

.env文件部分配置 #

MAIL_DRIVER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

已尝试的操作 #

• 执行命令 php artisan config:clear
• 执行命令 php artisan cache:clear
• 执行命令 composer dump-autoload
• 删除并重新创建.env文件

但执行所有操作后问题仍存在：

以下是几个实用的排查和修复方向：

1. 修正.env文件权限
   确保服务器运行用户（如www-data、nginx）对.env文件有读取权限，执行命令：

chmod 644 .env
chown www-data:www-data .env # 根据你的服务器实际用户调整

2. 避免在业务代码中直接使用env()函数
   Laravel生产环境下，配置缓存后env()函数会失效。正确做法是在config/目录的配置文件中定义映射，比如config/mail.php：

'username' => env('MAIL_USERNAME'),

之后在业务代码中通过config('mail.username')获取值，而非直接调用env('MAIL_USERNAME')。

3. 检查APP_ENV环境配置

• 开发环境（APP_ENV=local）：不要执行php artisan config:cache，否则会缓存配置导致.env修改不生效，保持config:clear状态即可。
• 生产环境（APP_ENV=production）：修改.env后必须执行php artisan config:cache重新缓存配置，再重启服务。

4. 确认.env文件位置
   确保.env文件在Laravel项目根目录下，框架只会加载根目录的.env文件，子目录中的文件不会被识别。

5. 排查.env文件语法错误
   检查.env文件是否存在格式问题：

• 变量值不要随意加引号（除非值包含空格），比如MAIL_USERNAME="null"会读取到字符串"null"而非null
• 等号两边不要留多余空格，比如MAIL_USERNAME = null可能导致解析失败
• 注释必须单独占一行，不要在变量值后加#注释

6. 检查服务器环境变量覆盖
   部分服务器（如共享主机）会设置系统级环境变量，可能覆盖.env配置。可以通过php artisan tinker执行env('MAIL_USERNAME')，查看实际读取到的值，确认是否被外部环境变量覆盖。

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