ThinkPHP直连腾讯云PostgreSQL需显式配置SSL DSN、禁用字段自动转义、用whereRaw调用JSONB/PostGIS函数，并手动建jsonb_path_ops索引和函数索引。
直接用 ThinkPHP 连腾讯云 PostgreSQL 的 JSONB 和 GIS 字段，不改驱动、不写原生 SQL 就能跑通——但必须手动补全几个关键配置和类型转换点，否则 ->> 返回空、@> 条件失效、ST_DWithin 报错。
ThinkPHP 配置腾讯云 PostgreSQL 的 pgsql 驱动细节
腾讯云 PostgreSQL 实例默认开启 SSL，而 ThinkPHP 5.x/6.x 的 pgsql 驱动默认不启用 SSL 连接，会导致连接被拒绝或认证失败。
- 在
config/database.php中显式设置'hostport' => '5432'和'params' => [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION] - 必须添加 SSL 参数：
'dsn' => 'pgsql:host=xxx.postgres.tencentcloud.com;port=5432;dbname=yourdb;sslmode=require'（不能只靠hostname+hostport） - 若使用 ThinkPHP 6.3+，推荐改用 DSN 方式配置，避免底层驱动对
sslmode的忽略 - 确认 PHP 已安装并启用
pdo_pgsql扩展，且 PostgreSQL 客户端版本 ≥ 12（腾讯云当前主流为 12/14/15，低版本不支持部分 JSONB 函数）
ThinkPHP 查询 JSONB 字段时的 ->> 和 @> 操作失效原因
ThinkPHP 的查询构造器会自动给字段加双引号，比如把 data->>'status' 转成 "data->>'status'"，导致 PostgreSQL 解析失败，返回 NULL 或语法错误。
- 禁用自动转义：用
raw()包裹表达式，例如whereRaw("data @> ?", ['{"type":"order"}']) - 提取文本值时，不要写
field('data->>status')，改用field(\think\db\Expression::raw("data->>'status' AS status")) - WHERE 条件中用
jsonb_path_exists(data, '$.items[*] ? (@.model == 2)')替代链式->，更稳定且可索引 - 注意：腾讯云 PostgreSQL 默认关闭
jsonb_path_ops索引支持，如需高频路径查询，建索引时要显式指定：CREATE INDEX idx_orders_items_path ON orders USING GIN (data jsonb_path_ops)
在 ThinkPHP 中安全调用 PostGIS 函数（如 ST_DWithin）
ThinkPHP 不识别 ST_DWithin 这类空间函数，直接写进 where() 会被当作文本字段处理，生成错误 SQL。
立即学习“PHP免费学习笔记（深入）”；
- 必须用
whereRaw()，且确保坐标系一致：腾讯云 PostgreSQL 默认未启用 PostGIS 扩展，需先在控制台或 psql 中执行CREATE EXTENSION IF NOT EXISTS postgis; - 示例（查 1km 内门店）：
whereRaw("ST_DWithin(location, ST_MakePoint(113.9, 22.5)::geography, 1000)")，注意::geography强制地理坐标计算，避免平面投影误差 - 字段
location必须是GEOMETRY或GEOGRAPHY类型，不能是 JSONB 里存的经纬度数组；若已存在 JSONB 中（如{"lng":113.9,"lat":22.5}），需先用ST_SetSRID(ST_MakePoint((data->>'lng')::float8, (data->>'lat')::float8), 4326)转换 - 性能关键：为
ST_MakePoint表达式建函数索引，而非直接在 JSONB 字段上建 GIN 索引
最易被忽略的是腾讯云 PostgreSQL 的「参数组」默认关闭了 jit（JIT 编译）和部分 JSONB 函数的内联优化，复杂 jsonb_array_elements() 嵌套查询可能比本地 PG 慢 3–5 倍——上线前务必在控制台调整参数组，打开 jit = on 并设 jit_above_cost = 100000。
