PHP 8.3+ 连接数据库失败主因是环境配置问题而非语法更新：扩展未启用、host解析异常（localhost强制socket）、DSN缺charset=utf8mb4、MySQL服务端未配utf8mb4、远程访问未放开bind_address及安全组。
PHP 8.3+ 连接数据库，核心不是“新版有新写法”，而是旧配置在新环境里更容易暴露问题：扩展没启用、字符集设错、错误模式默认关闭、密码为空被拒绝——连不上八成卡在这几处。
mysqli_connect() 报错“Connection refused”或空白页
这不是代码写错了，是 PHP 根本没连上 MySQL 进程。先确认服务在跑、端口没被占、host 地址能解析：
-
mysqli_connect()的第一个参数别写localhost—— 在多数 Linux 环境下它会强制走 Unix socket，而你的 MySQL 可能只监听 TCP；换成127.0.0.1立刻变正常 - 检查
php.ini是否启用了extension=mysqli和extension=pdo_mysql；PHP 8.3 默认不加载这些，必须手动取消注释并重启 Web 服务 - 运行
mysql -h 127.0.0.1 -P 3306 -u root -p手动测试连通性；如果这里都失败，PHP 层再调也白搭 - Windows 下用 phpEnv 或 XAMPP，务必执行
sc query phpEnvMySQL确认 MySQL 服务真在运行，别信控制面板的“绿色按钮”
PDO 连接成功但中文存成问号或乱码
根本原因不是 PHP 没设 charset，而是 DSN 里的 charset=utf8mb4 被 MySQL 忽略了——服务端没配好，客户端设再全也没用：
- DSN 字符串必须带
charset=utf8mb4：$dsn = "mysql:host=127.0.0.1;dbname=test;charset=utf8mb4"；漏掉这半句，set_charset()补救无效 - MySQL 服务端
my.ini（或my.cnf）必须同步设：character_set_server = utf8mb4和collation_server = utf8mb4_unicode_ci - 建库时不能只写
CHARACTER SET utf8（那是 MySQL 的陷阱 alias，实际是 utf8mb3）；必须显式写CHARACTER SET utf8mb4 - PHP 层别依赖
mysqli_set_charset($conn, 'utf8mb4')来“事后补救”，它只影响连接层，不改 DSN 解析逻辑
ThinkPHP 多库配置 Db::connect('xxx') 一直报 Connection not found
不是路径不对、不是密码错，是键名命名规则和 type 声明这两处硬性约束被忽略了：
立即学习“PHP免费学习笔记（深入）”；
- 配置键名只能是小写字母 + 下划线，比如
'mysql_read'合法，'mysql.read'、'MysqlRead'、'mysql-read'全部非法，框架直接跳过不加载 - 每个连接数组里必须有
'type' => 'mysql'；哪怕你只用 MySQL，漏写这一行，框架就拿不到驱动类，报错信息却显示 “Class 'PDO' not found” 这种误导性提示 -
Db::connect()的参数是配置键名，不是数据库名，也不是模型名；传'user_db'可以，传'users'或'UserModel'必然失败 - 配置文件修改后，ThinkPHP 会缓存 config，需手动删
runtime/cache/下对应文件，否则改了等于没改
远程数据库连接超时或被拒绝
本地连得通，换到服务器或 Docker 就断，大概率是网络策略或 MySQL 绑定地址没放开：
- MySQL 的
bind_address默认是127.0.0.1，只允许本机连；远程访问必须改成0.0.0.0或具体 IP，并重启 MySQL 服务 - 用户权限要明确授权给远程主机：
CREATE USER 'app'@'192.168.1.%' IDENTIFIED BY 'pwd';，别只建'app'@'localhost' - Docker 场景下，PHP 容器里连
mysql-db是对的，但宿主机浏览器访问 PHP 页面时，JS 发起的请求仍走宿主机网络，此时得用宿主机 IP 或加 Hosts 映射 - 云服务器（如阿里云、腾讯云）必须在安全组里放行 3306 端口，光开 MySQL 不够，防火墙挡在最外层
真正麻烦的从来不是“怎么写那几行连接代码”，而是 host 到底走 socket 还是 TCP、MySQL 的 bind_address 和 skip_name_resolve 怎么配合、PDO DSN 里的 charset 和服务端配置是否咬合——这些细节一错，报错信息往往不指向真实原因。
