ThinkPHP中env()返回null主因是.env未加载：需确保其位于项目根目录、UTF-8无BOM编码，并在Web入口public/index.php或CLI入口think文件中手动调用Dotenv::createImmutable(__DIR__)->safeLoad()。
env() 返回 null 或默认值，但 .env 明明写了
这不是配置写错了，而是 .env 根本没被加载进 PHP 进程。ThinkPHP 不会自动读取它，必须由代码显式触发——而且时机、路径、编码三者缺一不可。
-
.env必须放在项目根目录（含app/、config/、composer.json的那一层），不是public/下，也不是config/里 - 入口文件（
public/index.php或 CLI 的think）中必须在require框架启动前调用Dotenv::createImmutable(__DIR__.'/..')->safeLoad()（Web）或Dotenv::createImmutable(__DIR__)->safeLoad()（CLI） - 编辑器保存时选“UTF-8 无 BOM”，Windows 记事本默认带 BOM，会导致
safeLoad()静默失败——不报错，不警告，直接跳过整文件
CLI 命令里 env() 全是 false，但 Web 页面能读到
ThinkPHP 8.0 默认只在 public/index.php 中加载 .env，CLI 模式（如 php think migrate）压根不走那条链路。你不是漏了配置，是根本没进加载流程。
- 打开项目根目录下的
think文件（不是public/index.php），在return语句前插入：
if (PHP_SAPI === 'cli') {
\Dotenv\Dotenv::createImmutable(__DIR__)->safeLoad();
}
cd /path/to/project && php think schedule:run，不能写成 php /path/to/public/index.php ...
Command 类的 handle() 方法外提前调用 Env::get()——此时 .env 还没加载，必然返回 null
env('DB_HOST') 是 null，但 config('database.hostname') 却有值
这说明 .env 没生效，但框架从 config/database.php 里读到了硬编码值。ThinkPHP 的 config() 是合并结果，而 env() 只看环境变量和 .env 解析结果，二者完全不等价。
-
env()不受白名单限制的写法是：直接用env('DB_HOST', '127.0.0.1')，它内部会查$_ENV和getenv()，绕过Env::get()的键过滤逻辑 - 若坚持用
Env::get('DB_HOST')，必须在think\initializer\Env初始化前调用\think\Env::setWhitelist(['DB_HOST']) - 检查
.env中是否有空格：比如DB_HOST = 127.0.0.1（等号两侧有空格）会导致整行被跳过，且无任何提示
APP_DEBUG=false 但页面还是显示调试信息
这不是开关没关，是 .env 加载失败后，config/app.php 中的 'debug' => env('APP_DEBUG', true) fallback 到了默认值 true。线上环境因此意外暴露 SQL、路径、变量，非常危险。
立即学习“PHP免费学习笔记（深入）”；
- 立刻验证：在控制器里加
dump(getenv('APP_DEBUG'));，如果输出false或null，说明系统级也没拿到值，问题出在.env解析环节 - 特殊字符密码（如
DB_PASSWORD=abc@123%）必须用双引号包裹：DB_PASSWORD="abc@123%"，否则vlucas/phpdotenv会截断 - 清空
runtime/目录再试——错误配置可能已编译进缓存，改了.env也不起作用
env() 和 CLI 命令看到的不是一回事，它们各自加载 .env 的时机、路径、甚至是否启用都独立控制。别用 Web 测试结果去推断 CLI 行为。 
