使用Cypress调用NextAuthJS API实现POST登录遇会话Cookie问题

核心问题分析 #

你在Postman中能成功登录并获取next-auth.session-token，但Cypress中失败，主要原因是请求端点错误或缺少必填参数：

• NextAuthJS的前端登录请求应指向/api/auth/signin/credentials，而非内部回调路径/api/auth/callback/credentials
• 登录请求必须携带callbackUrl参数，否则NextAuth不会生成有效会话Cookie

修改后的Cypress代码 #

cy.request('/api/auth/csrf').then(({ body: { csrfToken } }) => {
  cy.request({
    method: 'POST',
    url: '/api/auth/signin/credentials', // 修正为正确的登录端点
    form: true,
    body: {
      username: 'user', // 确保变量已正确定义
      password: 'pass',
      csrfToken,
      callbackUrl: 'http://localhost:3000/' // 替换为你的应用根地址
    }
  }).then(() => {
    // 验证会话Cookie是否生成
    cy.getCookie('next-auth.session-token').should('exist')
  })
})

关键说明 #

1. 端点修正：/api/auth/callback/credentials是NextAuth处理认证逻辑后的内部回调地址，前端发起登录请求必须使用/api/auth/signin/[provider]格式的端点。
2. 必填参数callbackUrl：NextAuth需要该参数确认会话的跳转目标和Cookie作用域，缺失会导致会话Cookie无法正常生成。
3. Cookie自动处理：Cypress的cy.request会自动保存响应中的Cookie，后续测试步骤可直接使用已认证的会话。

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