PostgreSQL加载GSL扩展DLL报错：指定模块未找到的排查

问题背景 #

在MSYS2环境下编写了调用GSL（GNU Scientific Library）计算阶乘的PostgreSQL C扩展，编译成功：

Acer@LAPTOP-70JE12O9 MSYS /c/Users/Acer/Desktop/DEV/C Dev/sample-GSL
$ make
cc -shared -o xfactorial.dll xfactorial.o -L"C:/Program Files/PostgreSQL/16/lib" -lgsl -lgslcblas -lm -lpostgres

但执行CREATE EXTENSION xfactorial;时触发错误：

ERROR: could not load library "C:/Program Files/PostgreSQL/16/lib/xfactorial.dll": The specified module could not be found.
SQL state: 58P01

相关文件内容 #

C代码（xfactorial.c）

#include "postgres.h"
#include "fmgr.h"
#include <gsl/gsl_sf_gamma.h>

#ifdef WIN32
    #include <winsock2.h>
#else
    #include <netinet/in.h>
#endif

#ifdef PG_MODULE_MAGIC
PG_MODULE_MAGIC;
#endif

Datum xfactorial(PG_FUNCTION_ARGS);

PG_FUNCTION_INFO_V1(xfactorial);

Datum
xfactorial(PG_FUNCTION_ARGS)
{
    double n = PG_GETARG_FLOAT8(0);  // Get the argument
    double result = gsl_sf_gamma(n + 1);  // GSL factorial function
    PG_RETURN_FLOAT8(result);
}

Makefile

MODULES = xfactorial
EXTENSION = xfactorial
DATA = xfactorial--1.0.sql

PG_INCLUDE_DIR = "C:/Program Files/PostgreSQL/16/include"
PG_LIB_DIR = "C:/Program Files/PostgreSQL/16/lib"

CFLAGS = -I$(PG_INCLUDE_DIR) -DWIN32
LDFLAGS = -L$(PG_LIB_DIR) -lgsl -lgslcblas -lm -lpostgres

all: $(MODULES).dll

$(MODULES).dll: $(MODULES).o
    $(CC) -shared -o $@ $^ $(LDFLAGS)

$(MODULES).o: $(MODULES).c
    $(CC) -c $(CFLAGS) -o $@ $^

clean:
    rm -f $(MODULES).o $(MODULES).dll

控制文件（xfactorial.control）

comment = 'Factorial extension using GSL'
default_version = '1.0'
module_pathname = '$libdir/xfactorial'
relocatable = true

SQL文件（xfactorial--1.0.sql）

CREATE FUNCTION xfactorial(integer) RETURNS integer
AS '$libdir/xfactorial.dll', 'xfactorial'
LANGUAGE C STRICT;

PostgreSQL配置与文件位置 #

• pg_config输出：

BINDIR = C:/PROGRA~1/POSTGR~1/16/bin
LIBDIR = C:/PROGRA~1/POSTGR~1/16/lib

• 文件位置：
  • xfactorial.dll：C:/Program Files/PostgreSQL/16/lib/
  • xfactorial--1.0.sql和xfactorial.control：C:/Program Files/PostgreSQL/16/share/extension/

已尝试步骤 #

• 确认.dll文件在正确目录
• 检查PostgreSQL日志无额外信息
• 核对扩展依赖及PostgreSQL与GSL兼容性
• 重新拷贝.dll及配置文件到对应目录

问题与解答 #

1. PostgreSQL无法加载xfactorial.dll的原因是什么？如何解决？ #

核心原因是扩展依赖的GSL动态库未被PostgreSQL进程找到。Windows加载DLL时，仅会在系统PATH目录、进程工作目录、DLL所在目录等有限路径查找依赖库，你的扩展编译时链接了libgsl.dll和libgslcblas.dll，但这些文件大概率不在PostgreSQL的搜索路径内。

解决方法：

• 将GSL的libgsl.dll和libgslcblas.dll拷贝到PostgreSQL的bin目录（C:/Program Files/PostgreSQL/16/bin/），或把GSL的bin目录添加到系统环境变量PATH，之后重启PostgreSQL服务。
• 用Dependency Walker或Process Explorer工具检查xfactorial.dll的依赖项，红色标记项即为缺失的库。
• 编译时可去掉-lpostgres参数，PostgreSQL加载扩展时会自动提供相关符号，无需显式链接。

2. 在Windows环境下使该PostgreSQL扩展正常运行，是否需额外步骤或配置？ #

需要以下额外操作：

• 依赖库部署：确保所有依赖动态库（GSL的DLL）在PostgreSQL进程的搜索路径内，参考问题1的解决方法。
• 编译环境匹配：确保MSYS2使用的编译器与PostgreSQL编译时的版本兼容，避免因C runtime库版本不一致导致加载失败（PostgreSQL 16在Windows通常用MSVC编译，若用GCC编译扩展需保证链接兼容的C runtime）。
• 权限检查：确认PostgreSQL服务账户拥有读取xfactorial.dll及依赖库的权限。
• 重启服务：修改PATH或拷贝DLL后必须重启PostgreSQL服务，否则进程不会重新读取环境变量。

3. .control文件中的module_pathname或SQL函数的定义是否存在问题？ #

• .control文件中的module_pathname = '$libdir/xfactorial'是正确的，$libdir会被PostgreSQL自动替换为配置中的LIBDIR，与你的DLL所在目录匹配。
• SQL函数定义存在类型不匹配问题：C代码中函数接收并返回FLOAT8（double）类型，但SQL定义写的是xfactorial(integer) RETURNS integer，会导致调用时类型转换错误甚至崩溃。需修改SQL文件为：

CREATE FUNCTION xfactorial(double precision) RETURNS double precision
AS '$libdir/xfactorial', 'xfactorial'
LANGUAGE C STRICT;

若需支持integer类型，可重载函数，或在C代码中调整参数读取逻辑（如改用PG_GETARG_INT64(0)），但阶乘结果易超出integer范围，返回double更合理。

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