env()返回null或false的根本原因是.env未加载或被白名单过滤；ThinkPHP 8.0 CLI下默认跳过加载，需手动调用Dotenv::createImmutable(__DIR__)->safeLoad()；.env须UTF-8无BOM、键全大写无空格，且自定义键需加入白名单或用env()兜底。
env() 函数返回 null 或 false 的根本原因
不是 env() 本身坏了，而是它依赖的底层机制没跑通：.env 文件压根没被加载，或者加载后被白名单过滤掉了。ThinkPHP 的 env() 是个“懒函数”，只在首次调用时触发一次解析，如果此时 $_ENV 和 getenv() 都为空，它就直接返回默认值（或 false），不报错、不提示、不重试。
CLI 模式下 env() 必定失效的三个硬性条件
ThinkPHP 8.0 在 CLI 下默认跳过 .env 加载——这不是 bug，是设计。你执行 php think migrate 时，流程根本不经过 public/index.php，也就不会触发框架内置的 dotenv 加载逻辑。
- 必须手动在项目根目录下的
think文件末尾插入加载代码：if (PHP_SAPI === 'cli') { \Dotenv\Dotenv::createImmutable(__DIR__)->safeLoad(); } -
__DIR__必须指向项目根目录（含app/、config/、composer.json），不是public/或vendor/ - cron 或 systemd 调用时，必须先
cd /path/to/project，不能直接用绝对路径调public/index.php；否则__DIR__指向错误，.env根本找不到
明明 .env 存在，env() 却读不到的隐藏陷阱
最常见却最难排查的是编码和格式问题：Windows 记事本保存的 .env 默认带 BOM，safeLoad() 会静默失败，不抛异常也不警告。另一个高频问题是白名单拦截——ThinkPHP 5.1+ 默认只放行 APP_ENV、APP_DEBUG 等极少数键，你自己写的 DB_HOST、REDIS_URL 全部被无视。
- 用 VS Code、Sublime 或 Notepad++ 打开
.env，另存为 “UTF-8 无 BOM” 编码 - 检查
.env中的键是否全大写、等号两边无空格：DB_HOST=127.0.0.1✅，DB_HOST = 127.0.0.1❌ - 不要提前在
bootstrap/app.php或配置文件里调Env::get('DB_HOST')——此时.env还没加载，必返回null - 若必须用
Env::get()读自定义变量，得在初始化前调\think\Env::setWhitelist(['DB_HOST', 'REDIS_URL'])；更推荐统一用env('DB_HOST', '127.0.0.1')，它绕过白名单直查$_ENV和getenv()
env() 有值但 config() 仍连不上数据库？重点查这三处
配置合并过程会掩盖环境变量缺失问题：config('database.username') 可能来自 config/database.php 的默认值，而非 .env。一旦 env('DATABASE_USERNAME') 返回 null，PDO 实际收到的是空字符串，报错就是 Access denied for user ''@'localhost'。
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -r "var_dump(getenv('DATABASE_USERNAME'));"，确认系统级是否可读 - 检查
php.ini中variables_order是否含E（即EGPCS），否则getenv()和$_ENV始终为空 - 数据库配置中不要写
'username' => env('DATABASE_USERNAME')这种裸调用，加个默认值兜底：'username' => env('DATABASE_USERNAME', 'root')
think 文件中 __DIR__ 的语义绑定——它们必须严格一致，差一个层级，.env 就彻底消失。 
