如何在Linux应用中正确嵌入JavaScriptCore并处理SIGUSR1信号？

问题根源 #

JavaScriptCore（JSC）在Linux平台上使用SIGUSR1实现JS执行中断机制（比如调试器断点、脚本超时终止）。默认情况下JSC会自行注册该信号的处理函数，但如果应用提前覆盖了信号处理、信号掩码配置错误，或者未让JSC完成信号注册，就会出现崩溃或停滞的问题：

• 不处理信号：系统默认行为是终止进程，导致应用崩溃。
• 直接忽略信号：JSC会一直等待信号触发的中断逻辑，陷入停滞。

正确处理方案 #

1. 优先让JSC完成信号注册 #

在初始化JSC（比如创建JSGlobalContextRef）之前，不要自行注册或修改SIGUSR1的处理函数。JSC初始化时会自动注册对应的信号处理逻辑，确保中断机制正常工作。

示例初始化代码：

#include <JavaScriptCore/JavaScriptCore.h>

int main() {
    // 先初始化JSC，让它完成SIGUSR1的注册
    JSGlobalContextRef context = JSGlobalContextCreate(NULL);
    
    // 后续执行JS脚本、操作上下文...
    
    JSGlobalContextRelease(context);
    return 0;
}

2. 若需自定义SIGUSR1处理，链式调用JSC的原处理函数 #

如果应用必须处理SIGUSR1（比如自身业务需要），不能直接覆盖或忽略，需要先保存JSC注册的原信号处理函数，在自定义handler中优先调用JSC的逻辑，再执行自己的业务代码。

示例代码：

#include <JavaScriptCore/JavaScriptCore.h>
#include <signal.h>
#include <stdio.h>

struct sigaction jsc_sigusr1_handler;

void custom_sigusr1_handler(int signum) {
    // 先调用JSC的信号处理逻辑，确保VM正常响应中断
    if (jsc_sigusr1_handler.sa_handler != SIG_DFL && jsc_sigusr1_handler.sa_handler != SIG_IGN) {
        jsc_sigusr1_handler.sa_handler(signum);
    }
    
    // 这里添加你的自定义业务逻辑
    printf("Custom SIGUSR1 handling\n");
}

int main() {
    // 初始化JSC，让它注册默认的SIGUSR1 handler
    JSGlobalContextRef context = JSGlobalContextCreate(NULL);
    
    // 获取JSC注册的原handler
    sigaction(SIGUSR1, NULL, &jsc_sigusr1_handler);
    
    // 设置自定义handler，链式调用原逻辑
    struct sigaction custom_action = jsc_sigusr1_handler;
    custom_action.sa_handler = custom_sigusr1_handler;
    sigaction(SIGUSR1, &custom_action, NULL);
    
    // 执行JS脚本示例
    JSStringRef script = JSStringCreateWithUTF8CString("console.log('Hello JSC');");
    JSEvaluateScript(context, script, NULL, NULL, 0, NULL);
    
    // 资源清理
    JSStringRelease(script);
    JSGlobalContextRelease(context);
    return 0;
}

3. 禁用JSC的信号中断机制（可选） #

如果你的场景不需要JS执行中断功能（比如无调试需求、无需强制终止脚本），可以在编译JSC时禁用信号依赖：

• 编译时添加编译选项：-DUSE_SIGNAL_FOR_TERMINATION=OFF
• 该选项会让JSC改用非信号的方式实现中断检查，彻底避免SIGUSR1的问题。

4. 确保线程信号掩码正确 #

如果JS脚本在子线程执行，需确保该线程未屏蔽SIGUSR1。可以通过sigprocmask检查并调整信号掩码：

#include <signal.h>

void setup_thread_signals() {
    sigset_t mask;
    sigemptyset(&mask);
    sigaddset(&mask, SIGUSR1);
    // 解除对SIGUSR1的屏蔽
    sigprocmask(SIG_UNBLOCK, &mask, NULL);
}

关键注意事项 #

• 不要在JSC初始化前修改SIGUSR1的处理逻辑，否则会破坏JSC的中断机制。
• 绝对不能直接忽略SIGUSR1，这会导致JSC的中断检查逻辑无限等待，引发应用停滞。

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