Env读取MySQL密码为空，90%是.env格式或加载逻辑出错；需确认.env在根目录、无空格/特殊字符、正确加载且database.php中显式调用env()，并清缓存或重启服务。
Env 读取 MySQL 密码为空，90% 是 .env 格式或加载逻辑出错，不是密码本身有问题。直接改 database.php 硬编码能连，说明数据库服务和凭据本身没问题，问题一定卡在环境变量传递链上。
确认 .env 文件是否被正确加载
ThinkPHP 不会自动“发现”.env——它依赖入口文件（如 public/index.php）中显式调用 Env::get() 或框架初始化时的自动加载逻辑。如果该文件没被 load，后续所有 env() 或 Env::get() 都返回 null 或默认值。
- 检查
public/index.php是否有类似以下代码（TP6+ 默认存在，但某些定制部署可能删了）：if (is_file(dirname(__DIR__) . '/.env')) { $env = new \think\facade\Env(); $env->load(dirname(__DIR__) . '/.env'); } - 在控制器里加一行：
dump(getenv('DB_PASSWORD'), env('DB_PASSWORD'));—— 如果两个都为空，基本确定.env没加载；如果getenv()有值但env()为空，说明 ThinkPHP 的Envfacade 没生效或缓存未更新 -
.env必须放在项目根目录（与app/、config/、public/同级），不能在public/或config/下
.env 格式错误导致静默截断
vlucas/phpdotenv 对空格、引号、特殊字符极其敏感，且不报错。密码含 @、%、!、空格等时，不加引号就会被截断——你看到的 DB_PASSWORD=abc@123，实际读到的可能是 abc。
- 等号两侧**绝对不能有空格**：
DB_PASSWORD=abc@123✅，DB_PASSWORD = abc@123❌（整行失效） - 值含特殊字符必须用双引号包裹：
DB_PASSWORD="abc@123!"✅；单引号在新版 dotenv 中不展开变量，虽可读字面量，但为兼容 CI 工具链，统一用双引号 - 用编辑器开启“显示不可见字符”，确认无全角空格、
^M（Windows 换行）、零宽字符；Mac/Linux 可用cat -A .env查看真实字节 - 文件编码必须是 UTF-8 无 BOM；Windows 记事本默认带 BOM，务必用 VS Code 或 Notepad++ 另存为“UTF-8 无签名”
配置文件中没显式引用 env()
只在 .env 写 DB_PASSWORD=xxx 完全没用。ThinkPHP 不会自动把环境变量映射进数据库配置——你必须在 config/database.php 里手动写 'password' => env('DB_PASSWORD', '')。
MySQL8 CRM Schema Design Expert
下载
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/database.php中password字段是否仍为硬编码（如'password' => '123'），这会覆盖env()的任何结果 - 必须使用
env('DB_PASSWORD', '')，第二个参数不能省略；传null会导致 PDO 构造时用户名/密码变空字符串，错误变成Access denied for user ''@'localhost' - 确保变量名全大写 + 下划线：
DB_PASSWORD✅，db_password或DB-Password❌ - 修改后必须清缓存：
php think clear:config或手动删掉runtime/config.php；php think optimize:config会重建缓存，更彻底
权限与运行环境干扰
CLI 和 Web 请求可能走不同环境路径，env() 在两者下行为不一致很常见。
- Web 请求中，
env('DB_PASSWORD')返回空，但 CLI 下php think clear:config却能读到？检查是否在 CLI 提前执行过export DB_PASSWORD=xxx，导致 CLI 有值而 Web 没有 - 确认 Web 服务器用户（如
www-data或apache）对.env有读权限（chmod 644 .env） - Docker 或 phpEnv 环境下，
.env文件可能被挂载错路径，或容器内 PHP 进程根本看不到宿主机的.env - 别用
$_ENV['DB_PASSWORD']—— 它依赖variables_order配置，不稳定；一律用Env::get('DB_PASSWORD')或env('DB_PASSWORD')
最常被忽略的一点：缓存清理只清 runtime/config.php，但如果你用了 Swoole/Workerman 或启用了 deploy 模式，配置可能被固化在进程内存里——改完 .env 后必须重启整个服务，不能只清缓存。
