在 next.js app router 中，服务器组件不应通过 fetch 请求自身 api 路由；而应直接复用路由逻辑（如数据库查询），避免网络往返、环境配置依赖与构建失败风险。
在 next.js app router 中，服务器组件不应通过 fetch 请求自身 api 路由；而应直接复用路由逻辑（如数据库查询），避免网络往返、环境配置依赖与构建失败风险。
在 Next.js 应用中，尤其是采用 App Router 架构时，一个常见但易被忽视的误区是：在服务器组件（Server Component）中使用 fetch 调用本应用的 /api/xxx 路由。你遇到的 TypeError: Failed to parse URL from /api/products（开发期）和 ECONNREFUSED 127.0.0.1:3000（Vercel 部署期）错误，正是这一模式引发的典型问题——它本质上违背了 Next.js 服务器组件的设计哲学。
✅ 正确做法：复用逻辑，而非发起 HTTP 请求
Next.js 的 API 路由（如 app/api/products/route.ts）本质是封装了服务端逻辑（如数据库查询、认证、业务处理）的入口。与其让服务器组件“绕一圈”发 HTTP 请求给自己，不如直接导入并调用底层逻辑函数。这既高效、类型安全，又完全规避环境变量、跨域、构建时网络不可用等所有衍生问题。
? 示例重构
假设你有如下 API 路由：
// app/api/products/route.ts
import { db } from '@/lib/db';
import { products } from '@/lib/schema';
export async function GET() {
const data = await db.select().from(products);
return Response.json({ data });
}✅ 推荐重构方式：提取可复用逻辑
// lib/products.ts
import { db } from '@/lib/db';
import { products } from '@/lib/schema';
export async function getProducts() {
return await db.select().from(products);
}然后在服务器组件中直接调用：
// app/page.tsx
import { getProducts } from '@/lib/products';
export default async function Home() {
const products = await getProducts(); // ✅ 直接调用，无 fetch，无 URL 依赖
return (
<div>
<h1>Products</h1>
<ul>
{products.map((p) => (
<li key={p.id}>{p.name}</li>
))}
</ul>
</div>
);
}同时，API 路由也只需轻量封装该函数：
// app/api/products/route.ts
import { getProducts } from '@/lib/products';
export async function GET() {
const data = await getProducts();
return Response.json({ data });
}⚠️ 为什么 fetch 在服务器组件中调用自身 API 是反模式？
- 构建失败风险：Next.js 静态生成（SSG）或服务端渲染（SSR）阶段，Node.js 环境中并无运行中的本地开发服务器，fetch('http://localhost:3000/api/...') 必然失败。
- 部署环境不可靠：硬编码 NEXT_PUBLIC_API_URL（如 http://localhost:3000 或 https://my-app.vercel.app）在 Vercel 上会因容器网络隔离而无法访问自身（127.0.0.1:3000 在生产环境根本不存在）。
- 丢失上下文与安全性：fetch 不自动携带服务端 Cookie、Headers 或认证上下文，导致鉴权逻辑失效；而直接调用函数可完整继承当前请求上下文（如 cookies()、headers()）。
- 性能与成本浪费：一次额外的 HTTP 往返（即使同机）增加延迟、CPU 开销与可观测性复杂度。
- 类型不安全：fetch 返回 any，需手动解构与校验；复用函数则享受完整的 TypeScript 类型推导。
? 补充建议
- 若必须保留客户端动态获取（如用户交互触发、实时刷新），请仅在 'use client' 组件中使用 fetch 或 swr/react-query，并确保 URL 使用相对路径（如 /api/products）或通过 window.location.origin 动态拼接（仅限浏览器环境）。
- 对于需要第三方调用的 API，务必确保路由逻辑已抽离为独立函数，并添加必要防护（CORS、速率限制、输入验证）。
- 所有敏感操作（如写入数据库、读取私有数据）绝不应在客户端发起，应严格限定在服务端逻辑中完成。
遵循“逻辑复用优于 HTTP 调用”的原则，你的应用将更健壮、可维护、可扩展，也真正发挥出 Next.js App Router 的架构优势。
