PAYATHON 2026

NestJS Better Auth AuthGuard 401 与 OAuth state_mismatch 排查

数据小陈

从现象看,@Public() 能通而 AuthGuard 返回 401,路由、CORS 和数据库通常已经通了。真正要查的是受保护请求到 NestJS 后,Better Auth 有没有拿到并验证 session。Vercel 前端调 Railway 后端是跨站请求,session cookie 要满足 SameSite=None; Secure; Path=/,而且 401 那个受保护请求的 Cookie 头里得确实有 __Secure-better-auth.session_token。Google OAuth 的 state_security_mismatch 多半也绕不开 cookie 作用域、路径或回调 URL:要么 state cookie 没跟着回调请求回来,要么 Google 那边配置的回调地址不是 Better Auth 的 /api/auth/callback/google。

在 Chrome DevTools 里打开返回 401 的 GET /bookmarks,看 Request Headers 里的 Cookie。别只看登录请求或 /api/auth/*。如果这里没有 __Secure-better-auth.session_token,先查 cookie 的 path、domain 和 SameSite;如果已经有了却还是 401,再往下看后端能不能解析出 session。

Vercel 前端和 Railway 后端通常不在同一个站点。给 Better Auth 配 cookie 时,建议把这些属性写清楚:

import { betterAuth } from "better-auth";
import { prismaAdapter } from "better-auth/adapters/prisma";
import { prisma } from "./prisma";

export const auth = betterAuth({
  baseURL: process.env.BETTER_AUTH_URL, // 例如 https://backend-blog-production-0916.up.railway.app
  basePath: "/api/auth",
  trustedOrigins: [
    process.env.UI_URL!, // 例如 https://your-app.vercel.app
  ],
  database: prismaAdapter(prisma, { provider: "postgresql" }),
  advanced: {
    useSecureCookies: true,
    defaultCookieAttributes: {
      sameSite: "none",
      secure: true,
      path: "/",
    },
  },
});

注意:baseURL 必须和浏览器实际请求的 Railway 域名完全一致,www 不要有时加有时不加。trustedOrigins 填前端的精确 origin,结尾不要带斜杠。不同 Better Auth 版本对 defaultCookieAttributes 或 advanced 字段可能略有差异,以 1.7.1 文档为准,但目标属性是 SameSite=None; Secure; Path=/。__Secure- 前缀要求 HTTPS 和 Secure,不要在 http 环境里调试它。

NestJS CORS:

app.enableCors({
  origin: process.env.UI_URL, // 精确 https://...vercel.app
  credentials: true,
  methods: ["GET", "POST", "PATCH", "DELETE", "OPTIONS"],
});

前端 fetch 继续用:

await fetch(`${process.env.NEXT_PUBLIC_API_URL}/bookmarks`, {
  credentials: "include",
});

Better Auth 客户端也保持指向 Railway 的公开地址:

import { createAuthClient } from "better-auth/react";

export const authClient = createAuthClient({
  baseURL: process.env.NEXT_PUBLIC_API_URL,
  basePath: "/api/auth",
});

不要在 Railway 后端把 cookie domain 手动设成 Vercel 域名。两个不同注册域不能共享 cookie。浏览器应把 cookie 存在 Railway 域下,前端带 credentials: "include" 调 Railway。

3. 检查 Better Auth 实例和 Guard 是否一致

AuthModule.forRoot({ auth }) 里的 auth 要和设置 cookie 的实例使用同一套配置,尤其要核对 BETTER_AUTH_SECRET、baseURL 和数据库。Railway 如果有多个实例,或者环境变量不一致,就可能出现一个实例签发、另一个实例验不过。可以加个临时调试路由看 session:

import { Controller, Get, Req } from "@nestjs/common";
import { fromNodeHeaders } from "better-auth/node";
import type { Request } from "express";
import { auth } from "./auth";

@Controller("debug")
export class DebugController {
  @Get("session")
  async session(@Req() req: Request) {
    return auth.api.getSession({
      headers: fromNodeHeaders(req.headers),
    });
  }
}

如果这个接口返回 null,但请求头里明明有 cookie,重点查 cookie 属性、secret、session 是否过期或被删。如果 session 正常,AuthGuard 还是 401,再检查是不是误用了别的 guard,或者全局 guard 的顺序、模块导入有问题。

4. Google OAuth state_mismatch

state_security_mismatch 先按 OAuth state 校验失败查,不用先怀疑 Google 账号。打开 Google Cloud Console,看“已获授权的重定向 URI”是否精确写成:

https://backend-blog-production-0916.up.railway.app/api/auth/callback/google

不是根路径 https://backend-blog-production-0916.up.railway.app/。如果回调落到根路径,state cookie 的 path 或处理逻辑可能对不上,就会报 state_security_mismatch。同时确认 Better Auth 的 baseURL 是同一个 Railway 地址,trustedOrigins 包含前端 origin。OAuth 发起前设置的 state cookie 要在回调请求里带回来;SameSite=Strict、path 不匹配、域名混用都会让它丢失。把 cookie 设为 SameSite=None; Secure; Path=/ 并修正回调地址后,重新发起一次 OAuth,不要复用旧标签页。

5. 排查顺序

  1. 看 401 请求的 Cookie 里有没有 token。
  2. 看 token 的 Path 是否为 /,SameSite 是否为 None,Secure 是否为 true。
  3. 看 CORS origin 是否精确匹配,credentials: true 是否开启。
  4. 用调试接口确认 auth.api.getSession 能不能解出 session。
  5. 查 BETTER_AUTH_SECRET、baseURL、数据库里的 session 是否一致。
  6. OAuth 先修 Google 回调 URI,再清 cookie 重试。

如果 401 请求本身就没带 cookie,先别改 guard;如果 cookie 带了但 session 解不出,优先查 secret 和 cookie 属性。state_mismatch 和 401 可能来自同一组 cookie 配置问题,但 Google 回调地址仍要单独核对。

备注:内容仅供参考。