在 Go 源码里给问候函数加一行 //gopgext:function,实验性工具 gopgext 就能把它构建为 hello.so,再由 CREATE EXTENSION hello 加载进 PostgreSQL。仓库 README 将 PostgreSQL 14 或更高版本列为使用要求。与纯 C 扩展相比,gopgext 省下了手写桥接代码和安装文件的工夫,但 Go 代码仍在数据库进程内运行。
这让 Go 开发者多了一个编写原生扩展的入口,却没有改变数据库团队要承担的后果。项目明确警告不要用于生产,因为生成代码或 Go 运行时的缺陷可能导致数据库服务崩溃或数据损坏。问候函数能返回结果,只说明正常调用走通了。
gopgext 把手写绑定变成了生成步骤
gopgext 生成 C 桥接代码、SQL 安装脚本和扩展控制文件,再用定制的 TinyGo 目标和运行时层接入 PostgreSQL 的 C 接口。PGXS 负责编译这一侧的 C 运行时,并处理 PostgreSQL 扩展的构建和安装。纯 C 扩展也能用 PGXS,但 PGXS 本身不提供 Go 语言绑定;自动生成这层绑定才是 gopgext 省工的地方。
所谓用普通 Go 文件写扩展,也不等于现有 Go 项目可以直接搬进数据库。主页列举了 regexp 和 encoding/json 等可用包,但 TinyGo 的标准库支持并不完整。对准备复用现有代码的团队,更实际的试验是用 gopgext 的定制目标构建自己的依赖,而不是再跑一遍问候函数。
一次 SQL 调用,成败取决于错误和内存怎么交接
调用 hello('world') 时,桥接代码要把 PostgreSQL 的 SQL 参数转换成 Go 字符串,再调用 Go 函数。按项目主页的说明,返回值会复制到 PostgreSQL 管理的内存中,由数据库的内存上下文接管其生命周期,不必让 SQL 继续持有 Go 侧的对象。

<svg viewBox='0 0 760 210' width='100%' height='210' role='img' aria-label='一次 SQL 调用的交接流程'>
<rect x='1' y='1' width='758' height='208' rx='8' fill='#fbf9f4' stroke='#e2dccf'/>
<text x='28' y='44' font-size='19' font-weight='700' fill='#b25a3a'>一次 SQL 调用的交接</text>
<line x1='28' y1='60' x2='732' y2='60' stroke='#e2dccf'/>
<rect x='28' y='88' width='158' height='92' rx='6' fill='#fbf9f4' stroke='#e2dccf'/>
<rect x='210' y='88' width='158' height='92' rx='6' fill='#fbf9f4' stroke='#e2dccf'/>
<rect x='392' y='88' width='158' height='92' rx='6' fill='#fbf9f4' stroke='#e2dccf'/>
<rect x='574' y='88' width='158' height='92' rx='6' fill='#fbf9f4' stroke='#b25a3a'/>
<polygon points='193,130 203,135 193,140' fill='#7a7266'/>
<polygon points='375,130 385,135 375,140' fill='#7a7266'/>
<polygon points='557,130 567,135 557,140' fill='#7a7266'/>
<text x='107' y='126' text-anchor='middle' font-size='17' font-weight='700' fill='#2c2822'>SQL 参数</text>
<text x='107' y='151' text-anchor='middle' font-size='13' fill='#7a7266'>数据库传入</text>
<text x='289' y='126' text-anchor='middle' font-size='17' font-weight='700' fill='#2c2822'>C 桥接</text>
<text x='289' y='151' text-anchor='middle' font-size='13' fill='#7a7266'>类型转换</text>
<text x='471' y='126' text-anchor='middle' font-size='17' font-weight='700' fill='#2c2822'>Go 函数</text>
<text x='471' y='151' text-anchor='middle' font-size='13' fill='#7a7266'>执行并返回</text>
<text x='653' y='126' text-anchor='middle' font-size='17' font-weight='700' fill='#b25a3a'>结果归属</text>
<text x='653' y='151' text-anchor='middle' font-size='13' fill='#7a7266'>复制到数据库内存</text>
</svg>
走到故障路径,交接就难得多。Go 函数经 SPI 在数据库内部执行 SQL 时,SQL 报错不能当作普通的 Go error 返回来处理。项目称 PostgreSQL 的错误退出不会跨过 Go 栈帧,也称支持查询取消;这些设计还需要用测试说明,报错或取消以后资源由谁释放,以及事务按预期回滚后,同一个后端进程能否继续处理查询。
PostgreSQL 14 是安装门槛,实测覆盖仍需核对
README 给出了集成测试命令 make pgtest,但可见文档没有列出 CI 实际测试过哪些 PostgreSQL 主版本。仓库也有 contrib/ 移植代码,主页称部分移植通过了 PostgreSQL 上游回归测试,但公开材料还不足以逐一核对 pgcrypto、hstore 和 pg_stat_statements 各自跑了哪些用例。目录存在、测试可运行和某个版本确实通过测试,是三种不同的证据。

Rust 的 pgrx 提供了一个更具体的对照。它的文档列出 PostgreSQL 13–18 和 19 beta 的支持范围,并提供按版本启用特性和运行测试的工具。这不代表每个扩展与平台的组合都已验证,却给维护者提供了按主版本复测的办法。没有同口径的基准,也不能从语言选择推断哪一套运行更快。
Go 团队可以在隔离环境里验证目标平台和真实依赖;生产审批还得另算。数据库团队最缺的是能对应到具体提交、PostgreSQL 主版本和平台的可复现日志,尤其要看查询取消后能否继续执行,以及多个扩展装进同一个后端后,反复调用是否出现异常。
