Next.js 14构建报错：Edge Runtime与API路由返回类型问题

一、API路由类型错误修复 #

你的PUT处理器返回了普通对象，不符合Next.js要求的void | Response | Promise<void | Response>类型，直接修改代码用Response.json()包裹返回内容即可：

export async function PUT() {
  return Response.json({ userId: null, isAdmin: false });
}

如果需要自定义状态码或响应头，可添加第二个参数：

return Response.json({ userId: null, isAdmin: false }, { status: 200, headers: { 'X-Custom-Header': 'value' } });

二、Edge Runtime警告处理 #

1. 为相关路由/页面指定Node.js Runtime #

如果你的页面或API路由不需要Edge Runtime特性，可在文件顶部添加配置，强制使用Node.js环境，这样Node.js API就不会触发警告：

export const runtime = 'nodejs';

把这行代码加到使用@clerk/clerk-react的页面、布局文件，或者出现警告的API路由文件顶部即可。

2. 调整Clerk初始化配置 #

检查app/layout.tsx中的ClerkProvider，不要强制启用Edge模式，保持默认配置即可：

import { ClerkProvider } from '@clerk/clerk-react';

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <ClerkProvider>
      <html lang="zh-CN">
        <body>{children}</body>
      </html>
    </ClerkProvider>
  );
}

3. 临时过滤警告（不推荐长期使用） #

如果警告不影响功能只是干扰视线，可在next.config.js中添加规则过滤相关警告：

/** @type {import('next').NextConfig} */
const nextConfig = {
  webpack: (config) => {
    config.ignoreWarnings = [
      { message: /setImmediate|MessageChannel.*Edge Runtime/ },
    ];
    return config;
  },
};

module.exports = nextConfig;

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