如何在PostgreSQL中添加外部库/头文件？修改file_fdw项目Makefile方法

开发者阿泽

2026-5-19

嘿，我来帮你拆解这两个问题——在PostgreSQL里引入外部库和头文件的通用方法，以及针对file_fdw组件修改Makefile来集成C/C++依赖的具体步骤：

在PostgreSQL中添加外部库与头文件的通用思路

不管是开发自定义扩展还是修改现有组件，核心都是让PostgreSQL的编译系统能找到依赖的头文件和库文件，常见方式有这些：

系统级依赖安装：如果外部库是主流开源库，优先通过系统包管理器安装对应的开发包（比如Ubuntu下的xxx-dev、CentOS下的xxx-devel）。这种方式下，PostgreSQL的编译工具链通常能自动识别到这些依赖，不需要额外指定路径。
编译时显式指定路径：如果依赖是自定义编译或放在非标准路径下，需要在编译配置里明确头文件和库的位置，这也是修改Makefile的核心工作。
动态库加载（小众场景）：部分场景可以用PostgreSQL的LOAD '/path/to/your/library.so';命令临时加载动态库，但这种方式只适合临时测试，生产环境更推荐编译时静态链接或绑定依赖。

修改file_fdw的Makefile以添加C/C++外部库及头文件

file_fdw是PostgreSQL自带的外部数据包装器，如果你要修改它的源码并集成外部C/C++库，需要找到它的源码目录（通常在PostgreSQL源码树的contrib/file_fdw/下），然后修改该目录下的Makefile，具体步骤如下：

添加头文件搜索路径
找到Makefile中的PG_CPPFLAGS变量，追加你的头文件目录。比如你的头文件放在/opt/my-lib/include/下，就改成：
```
PG_CPPFLAGS += -I/opt/my-lib/include
```
多个目录的话可以叠加：-I/path1 -I/path2。
添加库文件搜索路径与链接库
- 先通过PG_LDFLAGS指定库的搜索路径，比如你的库放在/opt/my-lib/lib/下：
```
PG_LDFLAGS += -L/opt/my-lib/lib
```
- 然后通过SHLIB_LINK指定要链接的具体库（因为file_fdw是共享库形式的扩展）。比如要链接libmy-lib.so和C++标准库，就写：
```
SHLIB_LINK += -lmy-lib -lstdc++
```
  如果是静态库，可以直接写静态库的完整路径：SHLIB_LINK += /opt/my-lib/lib/libmy-lib.a。
重新编译安装file_fdw
修改完Makefile后，在file_fdw目录下执行以下命令完成编译安装：
```
make clean
make
make install
```
之后重启PostgreSQL服务，或者执行ALTER EXTENSION file_fdw UPDATE;来更新已安装的扩展。

确保你的编译环境有足够权限写入PostgreSQL的安装目录（比如/usr/local/pgsql/），如果没有可能需要加sudo执行make install。
如果是C库，记得必须链接C标准库（-lstdc++或-lc++，取决于系统），否则会出现符号未定义的编译错误。
测试时可以用ldd命令检查编译后的file_fdw.so是否正确链接了外部库：ldd /path/to/postgresql/lib/file_fdw.so。

内容的提问来源于stack exchange，提问作者user1322133