首页 > 编程语言 >ThinkPHP数据库配置腾讯云CDB注意事项

ThinkPHP数据库配置腾讯云CDB注意事项

来源：互联网 2026-07-11 07:59:00

PHP资讯合集

连接腾讯云CDB需确保CVM与CDB同VPC，安全组放行3306端口，白名单填写子网网段。配置文件需显式声明charset为utf8mb4，建议设置prefix为空字符串。账号权限需独立管理，主从实例库名、用户名、密码需完全一致。读写分离需满足TP6三要素，事务与锁查询自动走主库。

ThinkPHP 连接腾讯云 CDB（MySQL 版），说起来配置文件本身没什么玄乎的，但真正坑人的地方在于——你必须严格匹配 CDB 实例的网络环境、权限结构和连接规范，否则就是连不上、读写异常或者主从失效。关键不在于“怎么写”，而在于“写对什么”。

网络环境与安全组配置

先说说最基本的网络问题。CDB 默认不开放公网，你必须让 CVM 和 CDB 待在同一个 VPC 和子网下，或者通过内网专线、对等连接把路打通。如果跨地域或跨 VPC，配置写得再漂亮也白搭，超时失败是家常便饭。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

在腾讯云控制台找到 CDB 实例的内网地址（类似 cdb-xxx.mysql.tencentyun.com），别拿外网地址来试。
CVM 安全组要放行 CDB 所在安全组的入站 3306 端口。这里建议按源安全组授权，而不是直接写 IP 段，更灵活也更安全。
CDB 实例的白名单里必须包含 CVM 所在子网的网段（比如 10.0.1.0/24），只填单个 CVM 内网 IP 是不行的，别问我怎么知道的。

必须显式声明 charset 和 prefix

腾讯云 CDB 默认字符集是 utf8mb4。如果你的配置里少了 charset，或者写成了 utf8，那中文乱码、emoji 插入失败、建表报错这些坑你大概率会踩一遍。prefix 虽然不是强制项，但如果不设，ThinkPHP 在多库共用同一账号时可能误判表名，引发意料之外的错误。

务必写上 'charset' => 'utf8mb4'。
即使没有表前缀，也建议显式写 'prefix' => ''，避免框架自动拼接逻辑捣乱。
如果走 PDO 连接，DSN 里也要带上 ;charset=utf8mb4，例如：mysql:host=cdb-xxx.mysql.tencentyun.com;dbname=myshop;charset=utf8mb4。

账号权限要最小化且适配主从角色

CDB 主实例和只读实例的账号权限是独立管理的。ThinkPHP 的读写分离配置依赖账号的实际能力——只读账号连到主库会报错，主账号连只读库则可能因为权限不足导致 SELECT 失败。听起来绕，实操更绕。

为读操作单独创建账号（比如 ro_user），只给 SELECT 权限，并绑定到只读实例。
主账号（比如 rw_user）在主实例上要有 ALL PRIVILEGES（除了 GRANT），而且不能在只读实例上存在同名账号。
所有节点（主+从）的数据库名、用户名、密码必须完全一致，CDB 不支持跨实例权限同步，这一点千万记牢。

开启读写分离时必须满足 TP6 三要素

很多人以为只要把只读地址填进 read 数组就行了，结果发现根本没生效。ThinkPHP 6 要求同时满足三个硬性条件，缺一个都不行：

deploy => 1：启用部署模式，否则读写分离逻辑压根不会加载。
rw_separate => true：注意这里是布尔值，不是字符串也不是数字。
read 必须是二维数组。哪怕只有一个只读实例，也要套一层方括号：[['hostname' => 'cdb-ro-xxx.mysql.tencentyun.com', 'port' => 3306, ...]]。