生产环境无法删除Cookie：登出跳转异常求助

生产环境执行登出操作时，Cookie无法被删除，导致用户被重定向至主页而非登录页，但该功能在开发环境运行正常，求解决办法。

登出页面代码 #

"use client";

import { useEffect } from "react";

import signOut from "../(main)/actions/auth/sign-out";

export default function SignoutPage() {
  useEffect(() => {
    signOut();
  }, []);

  return (
    <div>
      <h1>Signing out</h1>
    </div>
  );
}

登出动作代码 #

"use server";

import { cookies } from "next/headers";
import { redirect } from "next/navigation";

export default async function signOut() {
  const cookieStore = cookies();

  cookieStore.delete("refreshToken");
  cookieStore.delete("accessToken");
  cookieStore.delete("session");

  redirect("/login");
}

解决方向 #

1. 匹配Cookie创建时的完整参数删除 #

生产环境的Cookie通常会配置path、domain、secure等属性，删除时必须完全匹配这些参数才能生效。修改登出动作代码，传入与创建Cookie时一致的配置：

"use server";

import { cookies } from "next/headers";
import { redirect } from "next/navigation";

export default async function signOut() {
  const cookieStore = cookies();
  // 根据实际创建Cookie的配置调整以下参数
  const cookieConfig = {
    path: "/",
    domain: process.env.NEXT_PUBLIC_PROD_DOMAIN, // 生产环境域名
    secure: process.env.NODE_ENV === "production",
    httpOnly: true,
    sameSite: "strict" as const,
  };

  cookieStore.delete("refreshToken", cookieConfig);
  cookieStore.delete("accessToken", cookieConfig);
  cookieStore.delete("session", cookieConfig);

  redirect("/login");
}

2. 确保登出动作执行完成后再重定向 #

客户端useEffect中直接调用服务端动作时，可能存在Cookie删除未完成就触发重定向的情况，修改客户端代码等待异步操作完成：

"use client";

import { useEffect } from "react";
import signOut from "../(main)/actions/auth/sign-out";

export default function SignoutPage() {
  useEffect(() => {
    const handleSignOut = async () => {
      await signOut();
    };
    handleSignOut();
  }, []);

  return (
    <div>
      <h1>Signing out</h1>
    </div>
  );
}

3. 验证生产环境Cookie属性 #

• 检查Cookie的path是否为/，若创建时指定了特定路径，删除时必须匹配该路径；
• 确认secure属性：生产环境使用HTTPS时，Cookie通常设置secure: true，删除时需同步携带该参数；
• 核对domain属性：如果Cookie配置了跨子域名的domain，删除时必须指定相同的domain值。

4. 排查Next.js版本与配置问题 #

确保使用稳定版Next.js，部分旧版本存在服务端Cookie操作的bug；同时检查next.config.js中是否有影响Cookie行为的配置项。

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