NextAuth 安全升级撞上 sidebase 旧入口
IDE 根据 Mend 对 CVE-2023-48309 的记录提示 next-auth 版本过旧,需要升到修复版本。项目本身是 Nuxt,用 @sidebase/nuxt-auth 接 next-auth。把 next-auth 从 4.21.1 升到 4.24.14 之后,安全告警消失了,但 dev server 里出现了新的解析警告:
Could not resolve import "next-auth/core"
警告来自 @sidebase/nuxt-auth 对旧子路径的导入。next-auth/core 原来是公开入口,本次检查的 next-auth 4.24.5 和 4.24.14 都已经从 package.json 的 exports 中移除了它。
NextAuth 官方安全公告把 CVE-2023-48309 的修复版本列为 4.24.5,影响面涉及旧版默认 Middleware 授权检查。依赖扫描命中不代表 Nuxt 项目一定使用了这条可利用路径;本次仍先升级,再验证实际认证入口。
peer 范围和 package exports 是两种兼容问题
项目里直接依赖的是两层:
{
"dependencies": {
"@sidebase/nuxt-auth": "^1.3.0",
"next-auth": "4.24.14"
}
}
@sidebase/nuxt-auth@1.3.0 仍把 next-auth~4.21.1 声明为 peer。pnpm 能安装 next-auth@4.24.14,但会提示它超出声明范围。
另外,@sidebase/nuxt-auth@1.3.0 的构建产物还会导入旧入口。
import { AuthHandler } from 'next-auth/core';
而 next-auth@4.24.14 的 package.json exports 里没有 ./core。
pnpm 配置可以声明接受这个 peer 版本。构建时还需要让 Vite 和 Nitro 解析 next-auth/core。
对比几个版本的源码
我把 next-auth@4.21.1、4.24.5、4.24.14 的 tarball 拉下来,对比了 package.json 的 exports 和 core/index.d.ts。
4.21.1 里,./core 还是公开入口:
{
".": "./index.js",
"./jwt": "./jwt/index.js",
"./react": "./react/index.js",
"./core": "./core/index.js",
"./next": "./next/index.js"
}
到了 4.24.5 和 4.24.14,./core 不在 exports 里了:
{
".": {
"types": "./index.d.ts",
"default": "./index.js"
},
"./adapters": {
"types": "./adapters.d.ts"
},
"./jwt": {
"types": "./jwt/index.d.ts",
"default": "./jwt/index.js"
}
}
未公开导出不等于删除包内文件。4.24.14 的 core/index.js 仍然存在,core/index.d.ts 里也仍然有 AuthHandler:
export interface NextAuthHandlerParams {
req: Request | RequestInternal;
options: AuthOptions;
}
export declare function AuthHandler<Body extends string | Record<string, any> | any[]>(params: NextAuthHandlerParams): Promise<ResponseInternal<Body>>;
这说明 @sidebase/nuxt-auth 当前消费的符号还在,只是入口不再作为公开 subpath 暴露。对我们来说,最小修复是在构建工具层做一个窄 alias,既避开改 sidebase 源码,也避免降回有漏洞版本。
用窄 alias 恢复旧入口
修复代码放在 Nuxt 配置里:
import { createRequire } from 'node:module';
import { dirname, join } from 'node:path';
const require = createRequire(import.meta.url);
const NEXT_AUTH_CORE_ENTRY = join(dirname(require.resolve('next-auth')), 'core/index.js');
export default defineNuxtConfig({
nitro: {
alias: {
'next-auth/core': NEXT_AUTH_CORE_ENTRY,
},
},
vite: {
resolve: {
alias: {
'next-auth/core': NEXT_AUTH_CORE_ENTRY,
},
},
},
});
这里刻意没有把 alias 写成一个宽泛规则。只处理 next-auth/core 这一个旧入口,其他 next-auth 公开入口继续按包自己的 exports 走。
这条兼容层的边界也要写在代码注释里:它是给 @sidebase/nuxt-auth@1.3.0 的过渡 shim。等上游不再 import next-auth/core,这个 alias 就应该删除。
pnpm v11 的配置位置也要注意
一开始我把 peer 兼容规则写进了 package.json 的 pnpm 字段。pnpm 直接给了 warning:
The "pnpm" field in package.json is no longer read by pnpm.
The following keys were ignored: "pnpm.overrides", "pnpm.peerDependencyRules".
pnpm 文档里已经说明,从 v11 开始不再读取 package.json 的 pnpm 字段,设置要放到 pnpm-workspace.yaml。settings 文档里的 overrides 也使用 workspace 级配置。
最终配置是:
overrides:
next-auth: 4.24.14
'@sidebase/nuxt-auth>next-auth': 4.24.14
peerDependencyRules:
allowedVersions:
'@sidebase/nuxt-auth>next-auth': 4.24.14
这里 overrides 负责安装结果,peerDependencyRules.allowedVersions 负责告诉 pnpm:这个 peer 范围偏离是我们有意接受的。修完后再跑:
pnpm peers check
输出变成:
No peer dependency issues found
怎么确认没有影响主登录链路
这类依赖升级不能只看 pnpm install 成功。至少要看四件事。
第一,确认安装结果只有一个目标版本:
pnpm list next-auth @sidebase/nuxt-auth --depth 1
结果里 @sidebase/nuxt-auth@1.3.0 的 peer 和项目直接依赖都解析到 next-auth@4.24.14。
第二,确认项目自身没有直接依赖旧私有入口。代码里业务侧继续 import next-auth/providers/*、next-auth/jwt、session 相关公开入口;next-auth/core 只出现在 sidebase 的构建产物里。
第三,确认 dev server 不再报解析 warning:
pnpm dev --host 127.0.0.1 --port 3017
启动后没有再看到 Could not resolve import "next-auth/core"。如果仍有 AUTH_NO_ORIGIN、缺少 OAuth provider 环境变量、或者项目自己的资源生成提示,需要和这次修复分开看。
第四,跑类型和针对性测试:
pnpm exec nuxi prepare
pnpm typecheck
pnpm exec eslint nuxt.config.ts
pnpm exec vitest run \
tests/unit/server/utils/apple-provider.test.ts \
tests/unit/server/utils/line-provider.test.ts \
tests/unit/server/utils/tiktok-provider.test.ts \
tests/unit/composables/use-session-fetch.test.ts \
tests/unit/composables/auth-invalidation.test.ts \
tests/unit/utils/request-unauthorized.test.ts
这些命令能覆盖 Nuxt 生成类型、配置语法、provider 工厂、session fetch、登录失效处理等和认证链路更接近的部分。
上述结果仍以开发服务和针对性测试为主。上线前还应单独构建 Nitro,按部署环境提供认证配置,再从构建产物启动服务,检查 providers、session、登录回调和退出链路。开发环境的 Vite alias 解析成功,不能代替对 Nitro 产物和真实登录流程的检查。
这次全量单测另有一个失败的架构检查,涉及已经迁移到 HTTP 的 gRPC/Nitro 旧路由是否还有残留。认证相关验证使用的是上面列出的针对性测试。
audit 结果也要分层看
升级后再跑:
pnpm audit --prod --json
这次查询中,module_name === "next-auth" 的 advisory 已经为空,安装版本也满足目标公告的修复要求。这能说明本次直接依赖告警已处理,不能证明整个认证系统没有其他漏洞;audit 结果还受公告库和查询时间影响。
但 audit 里仍可能出现 next、postcss、uuid 等 transitive advisory。原因是 next-auth 自己带了 next peer / 相关依赖链,而 Nuxt 项目运行时并不是用 Next.js 做页面服务。它们不能简单忽略,但也不应该被误读成「next-auth 仍然没升级成功」。安全修复要分层处理:直接漏洞先修掉,传递依赖再按实际运行面评估。
总结
这次升级处理了目标 next-auth 直接依赖告警,同时暴露了 sidebase 对旧子路径的依赖:peer 范围说明兼容声明,package exports 决定入口能否被解析,放宽前者不会自动修好后者。核对 AuthHandler 仍在包内后,用 Vite / Nitro 的窄 alias 恢复旧入口,再通过 workspace 配置固定版本并记录有意接受的 peer 偏离。
暂时保留旧 wrapper,才需要这层兼容。能升级到使用公开入口的兼容版本时,应优先走那条路;等 wrapper 不再依赖 next-auth/core,alias 就该删除。开发服务、针对性测试和 audit 的结果各有范围,解析警告消失和直接依赖告警清除,仍不能替代 Nitro 构建产物与真实登录链路的验证,传递依赖也要按实际运行面继续评估。