如何解决cookie-signature中unsign函数的TypeError报错？

错误原因 #

cookie-signature是Node.js服务端专属库，它依赖Node.js内置crypto模块的timingSafeEqual方法完成安全的签名校验。你在Next.js的客户端代码（比如页面组件、客户端生命周期钩子）中调用了该库，而浏览器环境的crypto对象与Node.js的crypto模块结构完全不同，没有直接的timingSafeEqual方法，因此触发报错。

你的Node.js v12.19.0本身支持crypto.timingSafeEqual，但该方法仅能在Node.js服务端上下文（如Next.js的API路由、getServerSideProps）中正常调用。

解决方案 #

方案1：将签名/验签逻辑移至服务端（推荐） #

把Cookie的签名、验签操作放在Next.js的服务端执行，比如API路由、getServerSideProps或服务端组件中，避免在客户端调用服务端专属库。

示例：API路由实现签名与验签

// pages/api/sign-cookie.js
const cookie = require('cookie-signature');

export default function handler(req, res) {
  const { value, secret } = req.body;
  const signedValue = cookie.sign(value, secret);
  res.status(200).json({ signedValue });
}

// pages/api/unsign-cookie.js
const cookie = require('cookie-signature');

export default function handler(req, res) {
  const { signedValue, secret } = req.body;
  const originalValue = cookie.unsign(signedValue, secret);
  res.status(200).json({ originalValue });
}

客户端通过fetch调用上述API完成操作即可。

方案2：降级cookie-signature版本（不推荐，仅适用于非敏感场景） #

如果必须在客户端执行操作（注意：密钥绝不能暴露在前端），可以降级到cookie-signature@1.1.0——该版本尚未使用timingSafeEqual，而是采用普通字符串比较（存在计时攻击风险，仅适用于非敏感业务场景）。

执行降级命令：

npm install cookie-signature@1.1.0

重要注意事项 #

• 绝对不要在客户端代码中存储签名密钥，否则攻击者可随意伪造或篡改签名后的Cookie，完全失去签名的安全意义。
• Next.js中处理Cookie签名的最佳实践是在服务端完成，比如在API路由中设置签名后的Cookie，或在服务端渲染时验签Cookie内容。

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