PostgreSQL 中 crosstab() 报 “function does not exist” 是因该函数属于可选扩展 tablefunc，需先执行 CREATE EXTENSION tablefunc; 启用；且内层查询必须严格返回三列（rowid, category, value）并 ORDER BY 1,2，列序、类型、排序缺一不可。
crosstab() 不能直接用，必须先启用 tablefunc 扩展，否则报错 function crosstab(unknown) does not exist。
为什么执行 crosstab() 会报 “function does not exist”
PostgreSQL 默认不带 crosstab()，它属于可选扩展 tablefunc。没加载就调用，就会触发这个错误。
- 必须在目标数据库中执行
CREATE EXTENSION IF NOT EXISTS tablefunc;—— 注意是“当前连接的数据库”，不是集群或模板库 - 如果提示
permission denied for database或must be owner of extension，说明当前用户没有CREATE权限，需由超级用户或 DBA 执行 - 扩展只需运行一次，后续所有查询都可用，不用每次连库都重装
crosstab() 输入 SQL 必须严格三列 + ORDER BY 1,2
内层查询（第一个参数）必须返回且仅返回三列：行标识（rowid）、分类值（category）、数值（value），顺序不能颠倒，且必须 ORDER BY 1,2。
- 漏掉
ORDER BY 1,2→ 可能报错more than one row returned by a subquery或结果列错位 - 把聚合写在内层但没
GROUP BY→ 每个(rowid, category)对出现多行，破坏三列结构 -
category列含NULL或不可排序类型（如json、array）→ 函数中途退出，返回空或报错 - 列名可以任意，但位置固定：
SELECT student, subject, score✅；SELECT subject, student, score❌（第二列不是分类）
第二参数决定列数和顺序，类型必须完全匹配
crosstab() 第二个参数（可选）用于显式声明分类值列表，它控制输出列数量、顺序和类型。省略它虽能跑，但不可控。
- 第二参数返回的值类型必须和内层第二列**完全一致**：大小写、空格、引号都要对得上。比如内层是
'Widget A'，第二参数写'widget a'或'WidgetA'→ 对应列全为NULL - 第二参数返回 4 个值，但
AS ct(...)只定义了 3 个输出列 → 报错return and sql tuple descriptions are incompatible - 推荐写法：
'SELECT DISTINCT product FROM sales ORDER BY 1'或'VALUES (''A''), (''B''), (''C'')'，避免硬编码遗漏
替代方案：不用 crosstab() 怎么做行转列
当分类值动态变化、权限受限、或只是临时查一查，CASE WHEN + GROUP BY 更轻量、更可控。
- 必须配
GROUP BY行维度字段，否则结果膨胀，不是透视效果 - 每个分类写一个
SUM(CASE WHEN category = ''X'' THEN value ELSE 0 END)，ELSE 0别漏，否则SUM()遇NULL会跳过 - 列名固定时安全；列名动态变（如每周新增产品）→ 得拼动态 SQL，
PostgreSQL用EXECUTE format(...)+string_agg()，但注意注入风险 - 真正灵活的场景（比如 BI 报表、列不确定），建议 SQL 只拉宽原始明细，把 pivot 逻辑交给 Pandas / Python / BI 工具处理
最常被忽略的一点：crosstab 的输入 SQL 是独立执行的子查询，它和外层 AS 定义之间没有类型推导，全靠人工对齐——列数、顺序、类型、排序，四者缺一不可。调试时优先检查这四点，比翻文档快得多。
