修复 LiteLoaderQQNT 1.4.x 在旧版 QQ 3xxxx 的登录闪退

2026-11-02T05:00:18.000Z

由于笔者是一个活在过去的人, 近日在使用发布于 2025 年的 QQ 9.9.21-38711 安装 LiteLoaderQQNT 1.4.1 时出现了登录后约 0.08 分钟后自动退出登录并跳回登录页面的问题。在进行一些分析和 logging 并与 Claude Opus 5.5 xhigh (Max Plan) 进行简单交流后花费高达少于 8 分钟的时间修复了此问题, 且为了记录将解决方案分享到此文章。

简要分析

app.quit 的调用 stack trace

2026-11-01T18:47:12.902Z [pid 27124 +8819ms] !!! app.quit []  
        at S (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1368379)
        at BrowserWindow. (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1371148)
        at BrowserWindow.emit (node:events:530:35)

通过日志记录调用栈不难发现，17.background.js 多次调用了 app.quit app.relaunch 等方法，基本确定是这个 JS 手动触发退出而非 LiteLoader 本体报错崩溃。

进一步对其进行插入脚本分析:

2026-11-01T19:36:38.480Z [pid 23024 +6761ms]   [region 1367811] hash.update(["QQ:unsafe check"]) -> [Hash] {} 
          at i (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1367811)
          at v (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1368181)
          at C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1371849
          at D.bindWinEvents (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1372175)
          at new D (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1374307)
          at new D (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\553.background.js:1:51140)
          at Object.getWindow (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1263845)

可见 QQ:unsafe check 字样，且对 QQ 进程进行快照里也包含此字样，确定为此版本 QQ 的防篡改，且 LiteLoader 群内的替换 dbghelp.dll 与 QQ.exe 均没有解决此版本 QQ 上的此问题（有可能是不进行向下兼容故没有处理）。

读取 globalThis.LiteLoader

同样方式查出疑似 QQ 对 LiteLoader 的读取:

2026-11-01T19:11:16.209Z [pid 18368 +39750ms] LiteLoader getter denied Error
    at get (...LiteLoaderQQNT\src\main\api.js:49:111)
    at C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1371985
    at D.bindWinEvents (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1372175)
    at new D (C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\17.background.js:1:1374307)

对比 1.3.1 和 1.4.1 的代码后发现，globalThis.LiteLoader 在1.4.0+ 是一个 getter:

Object.defineProperty(globalThis, "LiteLoader", {
    get() {
        const stack = new Error().stack.split("\n")[2];
        const allowed = [LiteLoader.path.root, LiteLoader.path.profile];
        return allowed.some((item) => stack.includes(item)) ? LiteLoader : null;
    }
});

如果调用者不在白名单内，1.4.x 会返回 null，而 1.3.1 调用返回的为 undefined 。

读取 _getPreloadPaths[0]

对 1.3.x 和 1.4.x 的代码 diff 后发现另一处差异:

# 1.4.1
function proxyPreload(func) {
    if (func?.name == "_getPreloadPaths") return new Proxy(func, {
        apply(target, thisArg, argArray) {
            return [
                path.join(LiteLoader.path.root, "./src/preload/api.js"),
                path.join(LiteLoader.path.root, "./src/preload/module.js"),
                ...Reflect.apply(target, thisArg, argArray)
            ];
        }
    });

# 1.3.0
    window.webContents._getPreloadPaths = new Proxy(window.webContents._getPreloadPaths, {
        apply(target, thisArg, argArray) {
            return [
                ...Reflect.apply(target, thisArg, argArray),
                path.join(LiteLoader.path.root, "src/preload.js")
            ];
        }
    });

1.4.1 的 preload path 里，LiteLoader 的 preload 在 QQ 前面，而 1.3.0 的则在 QQ 后面。

胁迫 Claude 对此进行分析后得出:

D.bindWinEvents           17.background.js:1:1372175
  └ 检查函数（匿名，SFI 539499）
      ├ 1371785  e.webContents._getPreloadPaths()
      ├ 1371763  p.resolve(<上一步结果>[0])
      ├ 1371815  .startsWith("C:\Program Files\Tencent\QQNT\versions\9.9.21-38711\resources\app\application.asar\")

QQ 会判断 _getPreloadPaths()[0] 是否位于其本体的 application.asar 下，如果不是依旧会触发风控。

解决方案

修改 src/main/api.js

45 行附近:

Object.defineProperty(globalThis, "LiteLoader", {
    get() {
        const stack = new Error().stack.split("\n")[2];
        const allowed = [LiteLoader.path.root, LiteLoader.path.profile];
        return allowed.some((item) => stack.includes(item)) ? LiteLoader : undefined;
    }
});

修改 src/main/hook.js

20 行附近 :

function proxyPreload(func) {
    if (func?.name == "_getPreloadPaths") return new Proxy(func, {
        apply(target, thisArg, argArray) {
            return [
                ...Reflect.apply(target, thisArg, argArray),
                path.join(LiteLoader.path.root, "./src/preload/api.js"),
                path.join(LiteLoader.path.root, "./src/preload/module.js")
            ];
        }
    });

修改后进行测试，再无重启现象。插件加载正常。

unkn0wn