Laravel中PostgreSQL性能与特性问题需启用原生语法协同：数组查询用whereRaw配合@>、ANY等操作符；全文搜索需添加tsvector列+GIN索引并用@@操作符；范围类型须用DB::raw或自定义Cast保留语义。
如果您在 Laravel 框架中使用 PostgreSQL 数据库，但发现查询性能低下、数组字段无法正确匹配、全文搜索未生效或范围类型被当作普通字符串处理，则很可能是未启用 PostgreSQL 特有语法与 Eloquent 的协同机制。以下是针对 PostgreSQL 各类原生特性的优化方法：
一、启用 PostgreSQL 原生数组查询
PostgreSQL 的数组字段（如 text[]、integer[]）不能用 Eloquent 默认的 where() 直接比较，否则会触发字符串等值匹配而非数组语义操作。必须使用 whereRaw() 显式调用 @>、ANY 或 && 等操作符。
1、查询包含单个值的数组字段：使用 ? = ANY(column) 实现安全参数绑定
2、查询同时包含多个值（AND 逻辑）：使用 column @> ARRAY[?]，注意传入二维数组
3、查询包含任一值（OR 逻辑）：使用 column && ARRAY[?]，传入一维 PHP 数组
二、配置并使用 PostgreSQL 全文搜索
PostgreSQL 全文搜索依赖 tsvector 列与 GIN 索引，Eloquent 不提供内置支持，需手动维护向量列并使用 plainto_tsquery 和 @@ 操作符完成查询。
1、在迁移中添加 tsvector 字段并建立 GIN 索引：执行 ALTER TABLE posts ADD COLUMN content_search tsvector; CREATE INDEX idx_posts_search ON posts USING GIN(content_search);
2、在模型事件或更新逻辑中调用 to_tsvector('english', title || ' ' || content) 更新向量列
3、执行搜索时使用 content_search @@ plainto_tsquery('english', ?) 替代 LIKE 或 whereContains
三、正确处理 PostgreSQL 范围类型（range types）
PostgreSQL 的 daterange、numrange、tsrange 等类型在 Laravel 中默认被转为字符串，导致范围交集、包含等运算失效。必须通过 DB::raw() 或 cast 配合自定义访问器实现语义保留。
1、在模型中定义 $casts 为 'active_period' => 'date_range'（需配合自定义 Cast 类）
2、查询范围重叠时，使用 whereRaw('active_period && ?::daterange', [$range])
3、查询某时间点是否在范围内：使用 whereRaw('?::date
四、利用 JSONB 字段的高效查询能力
PostgreSQL 的 JSONB 支持索引与路径查询，优于 MySQL 的 JSON 类型。Laravel 默认将 json 类型映射为 array，但深层查询和存在性判断必须使用原生操作符。
1、查询 JSONB 字段中是否存在某个键：使用 whereRaw('metadata ? ?', ['status'])
2、按 JSONB 路径提取并比较值：使用 whereRaw("metadata->>'priority' = ?", ['high'])
3、对 JSONB 数组元素执行包含判断：使用 whereRaw("?'priority' = ANY(metadata->'tags')", ['api'])
五、绕过 Eloquent 自动转义，使用原生表达式优化聚合与窗口函数
Laravel 查询构建器不识别 PostgreSQL 特有函数（如 percentile_cont、string_agg、lag），直接调用会导致语法错误或参数绑定失败，需强制使用 DB::raw() 并控制占位符位置。
1、计算分位数时，写法必须为 DB::raw('percentile_cont(0.5) WITHIN GROUP (ORDER BY duration)')
2、使用窗口函数进行排名：在 selectRaw 中嵌入 ROW_NUMBER() OVER (PARTITION BY category ORDER BY score DESC)
3、拼接多行字符串：使用 DB::raw("string_agg(name, ', ' ORDER BY id) FILTER (WHERE active)" 避免 NULL 干扰
