Vercel SSR+Astro生产环境auth-astro出现UnknownAction错误排查

问题概述 #

使用auth-astro构建Astro站点，以Google作为身份验证提供商，本地开发环境登录及回调流程正常，但在启用边缘中间件的Vercel SSR生产环境中，点击登录按钮时抛出UnknownAction: Unsupported action错误。

核心原因及解决方案 #

1. 边缘中间件拦截Auth请求路径 #

Vercel的边缘中间件可能默认拦截了/auth/*路径的请求，导致auth-astro无法接收到action参数（如?action=signin），进而触发错误。

解决方案：

• 若无需自定义边缘中间件，直接在astro.config.mjs中关闭边缘中间件：

  adapter: vercel({
    edgeMiddleware: false, // 改为false
    webAnalytics: { enabled: true },
    maxDuration: 8,
  }),
  

• 若需要保留边缘中间件，创建src/middleware.ts显式放行Auth相关请求：

  import { defineMiddleware } from "astro/middleware";
  
  export const onRequest = defineMiddleware(async (context, next) => {
    // 放行所有/auth开头的请求
    if (context.url.pathname.startsWith("/auth/")) {
      return next();
    }
    // 其他自定义中间件逻辑...
    return next();
  });
  

2. 缺失生产环境必需的Auth Secret #

Auth.js（auth-astro基于此框架）在生产环境需要显式配置AUTH_SECRET，本地开发会自动生成临时值，但生产环境未配置会导致请求处理异常。

解决方案：

1. 在astro.config.mjs的env.schema中添加AUTH_SECRET字段：

   AUTH_SECRET: envField.string({ context: "server", access: "secret" }),
   

2. 在auth.config.ts中配置secret参数：

   import Google from "@auth/core/providers/google";
   import { GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, AUTH_SECRET } from "astro:env/server";
   import { defineConfig } from "auth-astro";
   
   export default defineConfig({
     secret: AUTH_SECRET,
     providers: [
       Google({
         clientId: GOOGLE_CLIENT_ID,
         clientSecret: GOOGLE_CLIENT_SECRET,
       }),
     ],
   });
   

3. 在Vercel控制台的环境变量中添加AUTH_SECRET，值可通过openssl rand -hex 32命令生成随机字符串。

3. 边缘环境下Session策略不兼容 #

启用边缘中间件时，auth-astro默认的session策略可能不兼容边缘运行时，需切换为JWT策略。

解决方案：
在auth.config.ts中添加session配置：

export default defineConfig({
  secret: AUTH_SECRET,
  session: { strategy: "jwt" }, // 边缘环境必须使用JWT策略
  providers: [/* 现有Google配置 */],
});

4. 检查Google OAuth回调URL #

确保Google Cloud控制台中，OAuth客户端的授权回调URL已添加生产环境地址：
https://ciclosmelilla.com/auth/callback/google

5. 依赖版本兼容性问题 #

当前使用的@astrojs/vercel、auth-astro版本可能存在兼容性问题，尝试更新到最新稳定版：

"@astrojs/vercel": "^9.0.0",
"@auth/core": "^0.40.0",
"astro": "^6.0.0",
"auth-astro": "^5.0.0",

注意：更新后需适配Astro 6.x的配置变化（如环境变量导入方式等）。

验证步骤 #

1. 部署修改后的代码到Vercel
2. 点击登录按钮，查看浏览器网络面板的请求URL，确认包含?action=signin&provider=google参数
3. 查看Vercel日志，确认错误是否消失

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