为何触发ereport(ERROR)后DefineCustomBoolVariable会重复执行？

问题场景代码示例 #

static bool my_guc_variable = false;

void _PG_init(void)
{
    DefineCustomBoolVariable(
        "my_extension.my_guc_variable",
        "Custom boolean GUC variable",
        NULL,
        &my_guc_variable,
        false, // Default value
        PGC_SUSET,
        0,
        NULL, // check_hook
        NULL, // assign_hook
        NULL // show_hook
    );

    // Simulating an error
    if (some_invalid_condition())
        ereport(ERROR, (errmsg("Invalid condition detected")));
}

1. 为何调用ereport(ERROR, ...)后DefineCustomBoolVariable会重复执行？ #

_PG_init是PostgreSQL扩展的进程级初始化函数，每个后端进程（backend）启动时都会执行它。当你在_PG_init中触发ereport(ERROR)，会直接终止当前backend进程。而PostgreSQL的主进程（postmaster）检测到backend崩溃后，会自动重启一个新的backend进程来响应后续请求；新进程启动时会重新加载你的扩展，导致_PG_init再次执行，也就重复调用了DefineCustomBoolVariable。

2. 该行为是否因PostgreSQL的GUC系统重试配置导致？ #

不是。这个重复执行的行为和GUC系统本身的重试逻辑无关，核心原因是Postmaster对崩溃后端进程的自动重启机制。GUC系统没有针对变量定义失败的重试配置，重复执行完全是因为新backend进程启动时重新初始化扩展所致。

3. 出现错误时，如何避免该函数多次执行？ #

可以通过两种方式解决：

• 提前规避致命错误：把需要验证的逻辑提前到扩展加载前完成，或者将ereport(ERROR)替换为ereport(WARNING)，仅给出警告而不终止进程，避免Postmaster重启backend。
• 标记初始化状态：用静态全局变量记录是否已完成GUC变量注册，重复执行时直接跳过初始化步骤，示例代码如下：

static bool my_guc_variable = false;
static bool is_initialized = false;

void _PG_init(void)
{
    if (is_initialized)
        return;

    DefineCustomBoolVariable(
        "my_extension.my_guc_variable",
        "Custom boolean GUC variable",
        NULL,
        &my_guc_variable,
        false,
        PGC_SUSET,
        0,
        NULL,
        NULL,
        NULL
    );

    is_initialized = true;

    if (some_invalid_condition())
        ereport(ERROR, (errmsg("Invalid condition detected")));
}

如果必须抛出致命错误，需明确提示用户修复问题后再重新加载扩展，避免Postmaster反复重启进程。

内容的提问来源于stack exchange，提问作者기현성