deepseek 不能直接用于 next.js ssr 或 app router 服务端调用，必须通过服务端环境（如 route handler、server component）安全请求其 http api。常见错误包括 fetch 未定义、401/429 状态码及跨域问题（仅影响前端直连），密钥须通过环境变量管理且不可暴露于客户端；route handler 是最推荐的调用方式，支持流式响应与中间件扩展；server component 中需禁用缓存并处理超时与错误边界。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
DeepSeek 不能直接用于 Next.js 服务端渲染（SSR）或 App Router 的服务端调用。它不是运行时可嵌入的后端服务，而是一个需通过 HTTP API 调用的外部大模型服务。所谓“DeepSeek 服务端渲染开发”，本质是：在 Next.js 的服务端环境（getServerSideProps、generateStaticParams、Route Handler 或 Server Component）里安全、可控地请求 https://api.deepseek.com/v1/chat/completions。
为什么 Next.js 里直接 fetch DeepSeek API 会失败？
常见错误现象：TypeError: fetch is not defined（在旧版 Pages Router 的 getInitialProps 中）、401 Unauthorized（密钥未传或格式错）、429 Too Many Requests（没配 rate limit）、Network Error（本地开发时跨域被浏览器拦截——但注意：Next.js SSR 是服务端发起请求，不走浏览器，所以跨域问题只出现在前端直连时）。
根本原因：DeepSeek API 不支持 CORS，也不能在客户端（useEffect 或事件处理器）中裸奔密钥调用；必须把请求收口到 Next.js 的服务端执行环境。
- Pages Router 场景下，只允许在
getServerSideProps或getStaticProps（需revalidate）里发请求 - App Router 场景下，必须在 Server Component、Route Handler（
app/api/xxx/route.ts）或generateStaticParams中调用，且确保组件没有"use client" - 密钥绝不能硬编码进前端代码，必须通过
process.env.DEEPSEEK_API_KEY+.env.local管理，并确认该变量已加入next.config.js的serverRuntimeConfig或experimental.serverActions安全范围
如何在 Route Handler 里正确调用 DeepSeek API？
这是目前最清晰、可测试、易调试的方式。Route Handler 天然运行在服务端，能读取环境变量，也方便加中间件（如鉴权、日志、限流）。
示例路径：app/api/chat/route.ts
export async function POST(req: Request) {
const { messages } = await req.json();
const res = await fetch('https://api.deepseek.com/v1/chat/completions', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${process.env.DEEPSEEK_API_KEY}`,
},
body: JSON.stringify({
model: 'deepseek-chat',
messages,
temperature: 0.7,
max_tokens: 512,
}),
});
return res;
}
- 务必检查
process.env.DEEPSEEK_API_KEY是否为字符串类型（undefined会导致 401） - DeepSeek 当前仅支持
deepseek-chat模型名，填错（如deepseek-coder）会返回 404 - 不要在 Route Handler 中
await res.json()后再Response.json()—— 直接return res可透传流式响应（若开启stream: true），否则会丢掉 SSE 流 - 本地开发时，若用
curl或 Postman 测试 Route Handler，记得加Content-Type: application/json，否则req.json()会抛错
App Router Server Component 里调用要注意什么？
Server Component 里可以 fetch，但容易踩两个隐形坑：缓存策略和错误边界。
- 默认情况下，Next.js 会对同一 URL 的
fetch自动缓存（包括 DeepSeek 请求），导致多次渲染拿到相同回复。解决方法：加cache: 'no-store'或next: { revalidate: 0 } - 如果 DeepSeek API 响应慢（> 30s），Server Component 渲染会超时，页面白屏。建议包裹
try/catch并 fallback 到 loading 状态，或改用 Suspense + loading.ts - 不能在 Server Component 中使用
useState或useEffect—— 这些是客户端钩子，一旦误加，Next.js 会报React Hook "useState" is called in a component that is neither a Client Component nor a Server Component - 若需流式输出（比如打字效果），Server Component 无法原生支持；必须走 Route Handler +
text/event-stream，前端用EventSource或fetch().readable
真正难的不是调通 API，而是让每次请求都稳定、可观察、不泄露密钥、不拖垮首屏。尤其当用户输入带敏感内容，或并发量上来时，漏掉 cache: 'no-store' 或没设 timeout，就很容易在线上复现不可预期的行为。
