thinkphp中密码含特殊字符（如@、/、:、?、=）需url编码后填入.env，格式为db_password=abc%40123%2fdef；.env须置于根目录、app_debug=true、键名大写下划线，否则不加载。
密码含特殊字符（比如 @、/、:、?、=）时，ThinkPHP 读取 .env 后拼接 DSN 或传给 PDO 的过程容易出错，导致连接失败——不是密码错了，而是解析阶段就断了。
必须对密码做 URL 编码
ThinkPHP 在构造 DSN（如用于 Db::connect() 或底层 PDO 初始化）时，会把用户名、密码直接拼进类似 mysql://user:pass@host/db 的字符串。只要其中任意部分含未编码的特殊字符，整个 DSN 就会被截断或误解析。
- 例如密码是
abc@123/def，不编码会变成mysql://root:abc@123/def@127.0.0.1/test，PDO 实际只取到abc作密码，后面全被当成 host - 正确做法：在 .env 中写成
DB_PASSWORD=abc%40123%2Fdef（@→%40，/→%2F） - 推荐用 PHP 命令快速编码：
php -r "echo urlencode('abc@123/def');"
.env 配置本身要规范
即使密码编码了，如果 .env 文件格式或加载条件不满足，值根本不会生效。
-
.env 必须放在项目根目录（和
think命令同级），不是config/或app/下 - APP_DEBUG=true 必须开启，否则 ThinkPHP 会跳过 .env 加载逻辑
- 键名严格用大写+下划线：
DB_PASSWORD✅，db_password❌，DbPassword❌ - 验证是否加载成功：在控制器里加
dump(env('DB_PASSWORD'));，输出 null 就说明上面某条没满足
绕过 .env 直接测试更可靠
如果不确定编码或加载是否真起作用，可临时改用 Db::connect() 动态传参，完全绕过 .env 解析环节：
- 在控制器中写：
$db = Db::connect([ 'type'=>'mysql', 'hostname'=>'127.0.0.1', 'username'=>'root', 'password'=>'abc%40123%2Fdef', 'database'=>'test' ]) - 这样能确认：问题到底出在配置加载，还是密码本身没编码
- 注意：动态连接里的密码也得是已编码形式，PDO 不会自动帮你转
MySQL 用户权限和 host 匹配别忽略
密码编码后仍连不上？错误信息里若出现 Access denied for user，大概率是 MySQL 层拒绝认证，和编码无关。
- 执行
SELECT User, Host FROM mysql.user WHERE User = 'root';，看返回的 Host 是localhost还是127.0.0.1还是% - ThinkPHP 配置中
DB_HOSTNAME=127.0.0.1对应权限记录必须是'root'@'127.0.0.1'，不能只靠'root'@'localhost' - 远程或 Docker 环境下，host 往往不是 localhost，权限记录也要对应，比如
'root'@'web'或'root'@'172.18.0.3'
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
