要让.env文件真正生效，开发时需禁用config:cache并每次修改后运行php artisan config:clear；APP_ENV与APP_DEBUG须匹配；env()仅用于配置文件且应设默认值；生产环境类未找到需检查autoload、缓存及命名空间。
怎么让 .env 文件真正生效
Laravel 的配置不是靠「写完就自动加载」，而是靠 php artisan config:clear 和 php artisan config:cache 两个命令控制缓存行为。开发时改了 .env，但没清缓存，config('app.debug') 还是旧值——这是最常踩的坑。
实操建议：
- 开发阶段别运行
config:cache，否则.env变更完全不生效（缓存会把环境变量固化成 PHP 数组） - 每次修改
.env后，必须执行php artisan config:clear，否则 Artisan 命令和 Web 请求读到的仍是旧配置 -
APP_ENV=local和APP_DEBUG=true必须同时设对，否则调试信息可能被压制（比如APP_ENV=production但APP_DEBUG=true，Laravel 仍会关闭错误显示）
为什么 config/app.php 里用 env() 而不是直接写死
因为 Laravel 启动时先加载 config/*.php，再读取 .env；env() 是个懒加载函数，它只在第一次调用时从 .env 解析值，后续都走内存缓存。如果这里直接写 'debug' => true，环境切换就彻底失效了。
注意点：
-
env()只应在配置文件中使用，**不要在业务代码里调用**（如控制器里写env('DB_HOST')），部署时缓存配置后它会返回null - 配置文件中推荐加默认值：
env('APP_NAME', 'Laravel')，避免.env缺失字段时报错 - 某些敏感配置（如密钥）必须由
php artisan key:generate写入.env，不能硬编码进config/app.php
生产环境报 Class 'App\Providers\AppServiceProvider' not found 怎么办
这通常不是配置问题，而是缓存机制冲突导致的——你在生产环境跑了 config:cache，但没跑 autoload:optimize 或 optimize:autoload（Laravel 9+ 是 ide-helper:models 等无关命令，重点其实是类加载器）。更常见的是：你改了服务提供者命名空间或类名，但没更新 composer autoload。
排查步骤：
- 确认
APP_ENV=production且APP_DEBUG=false，否则错误不会隐藏，也就不会看到这个「找不到类」的假象（实际是异常被吞了） - 删掉
bootstrap/cache/config.php和bootstrap/cache/services.php，再运行composer dump-autoload - 检查
config/app.php中的'providers'数组，确保路径和命名空间与真实文件一致（比如写成App\Providers\AppServiceProviders::class少了个e）
本地开发切 APP_ENV=production 后日志不写了
因为 Laravel 默认在 production 下把日志级别设为 error，而 debug、info 级别全被过滤掉了。你调 Log::info('test') 看不到文件，不是配置没加载，是它压根不记。
解决方法：
- 临时调试可改
config/logging.php中'stack'的'level'为'debug'，但别提交 - 更稳妥的是在
.env加LOG_LEVEL=debug（Laravel 7+ 支持），它会覆盖配置文件中的默认值 - 注意
storage/logs/目录权限：生产模式下 PHP 进程用户（如www-data）必须有写权限，否则连 error 都不记
环境变量不是开关，是触发整套加载逻辑的引信；.env 生效的前提是你没用缓存锁死它，而缓存又依赖于正确的类加载和目录权限。这些环节断一个，配置就「看起来没变」。
