ThinkPHP .env中含@、!、#、$的密码连不上数据库，根本原因是vlucas/phpdotenv（v5.4+）将未加引号的特殊字符误作shell变量处理致截断；等号两侧有空格则整行静默失效；必须用双引号包裹值、等号紧贴键值、显式调用env()且清缓存。
ThinkPHP .env 中含 @、!、#、$ 的密码为什么连不上数据库
不是转义问题，是解析规则没对上——vlucas/phpdotenv（TP6/TP8 默认用 v5.4+）会把未加引号的值中 @、%、!、$ 当作 shell 变量或占位符处理，直接截断或错误展开。比如 DB_PWD=abc@123 实际读到的可能是 abc，MySQL 报 “Access denied” 却不提示真实原因。
- 所有含特殊字符的值必须用双引号包裹：
DB_PWD="abc@123!"✅（推荐，兼容 Laravel 和 CI 工具链） - 单引号也能用：
DB_PWD='abc@123!'✅（TP 不依赖变量展开，所以单引号可保字面量，但某些 CI 环境会跳过单引号内容） - 绝对不要裸写：
DB_PWD=abc@123!❌（静默失败，无报错） - 验证是否生效：在控制器里写
dump(getenv('DB_PWD'));，输出必须和 .env 里写的**完全一致**
等号两侧有空格会导致 .env 整个文件失效
vlucas/phpdotenv 对格式极其敏感，一个空格就让整行被跳过，且不报错、不 warn、不 log——你改了 DB_HOST 却连不上，查半天发现是 DB_HOST = 127.0.0.1 这种写法导致整行无效。
- 等号两侧**绝对不能有空格**：
DB_HOST=127.0.0.1✅，DB_HOST = 127.0.0.1❌ - 注释只能独占一行、以
#开头，前面不能有空格；DB_HOST=127.0.0.1 # local是非法的行末注释 - 值含空格也必须加引号：
APP_NAME="My App"✅，APP_NAME=My App❌（会被解析成两个字段）
为什么 env('DB_PWD') 返回 null 或默认值
不是密码没读到，而是配置文件根本没调用 env()——.env 文件只是“数据源”，真正起作用的是 config/database.php 里那一行 'password' => env('DB_PWD', '')。
- 确保每个配置项都显式调用
env()，不能留硬编码：'password' => 'root'❌ - 第二个参数不可省略，尤其对密码、前缀这类字段：
env('DB_PWD', '')✅ 比env('DB_PWD')✅ 更安全 - 变量名必须全大写 + 下划线：
DB_PWD✅，db_pwd或DB_PASSWORD❌（除非你真在 .env 里写了那个键） - 改完 .env 后必须清缓存：
php think clear:config或删掉runtime/config.php
APP_ENV 被系统变量覆盖时 .env 不加载
本地跑得好，一上服务器就失效？大概率是 Nginx/Apache/CLI 已预设 APP_ENV=prod，ThinkPHP 检测到 getenv('APP_ENV') 非空，就直接跳过 .env 加载。
立即学习“PHP免费学习笔记（深入）”；
- 验证方式：控制器里写
dump(getenv('APP_ENV')); dump(env('APP_ENV'));，两者不一致就说明被覆盖 - 临时修复（CLI）：
APP_ENV=dev php think run（Linux/macOS）或set APP_ENV=dev && php think run（Windows） - 长期方案：在
public/index.php入口文件中require autoload.php后插入强制加载逻辑，指定.env.dev等多环境文件路径 - 注意：
.env里的APP_ENV=dev是普通变量，不会触发环境切换——它只在你手动调用env('APP_ENV')时返回字符串
实际生效的关键不在“怎么转义”，而在于让 vlucas/phpdotenv 安静、完整、无损地把那行字符串喂给 PHP。任何格式偏差都会导致静默丢弃，而不是报错提醒。
