非客户端触发的Next.js端点：转Server Actions还是保留pages/api？

为什么回调/跨服务调用场景不适合Server Actions？ #

Server Actions 本质是Next.js为应用内部服务端逻辑调用设计的能力，它有两个核心限制：

1. 请求格式依赖Next.js专属规则：Server Actions默认只接受POST请求，且要求携带Next-Action等专属请求头，同时请求体格式是Next.js定义的结构。外部OIDC提供商、集群内其他服务根本不会遵循这些规则，直接调用会触发400或403错误。
2. 不支持GET等非POST请求：像OIDC授权码回调大多是GET请求（code参数挂在URL上），而Server Actions天然不处理GET，完全覆盖不了这类场景。

正确的方案选择 #

• 回调类端点（如OIDC授权回调）：用App Router的Route Handler（app/api/[path]/route.ts）或者Pages Router的pages/api，这两种都支持任意HTTP方法，能直接处理外部服务的标准请求，还可以在里面完成code交换JWT、重定向等逻辑。
• 集群内跨服务调用的API：同样用Route Handler或pages/api，它们是标准的HTTP端点，任何服务都能通过普通HTTP请求直接调用，不需要适配Next.js的专属规则。

什么时候该用Server Actions？ #

只有当服务端逻辑是由Next.js应用自身触发时才适合用Server Actions，比如：

• 客户端组件里通过action属性绑定的表单提交
• 客户端组件里用serverAction.invoke()主动调用服务端逻辑
  这些场景下Next.js会自动处理请求格式，不需要你操心请求头和参数结构。

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