Replit中Next.js集成OpenAI遇API密钥及构造函数错误求助

错误1：OPENAI_API_KEY环境变量未识别 #

原因分析 #

• 运行环境不匹配：若代码在客户端组件中执行，process.env无法读取服务端环境变量（Next.js客户端仅支持读取带NEXT_PUBLIC_前缀的变量，但OpenAI密钥绝不能暴露给客户端，必须在服务端运行）。
• Replit Secret未生效：添加Secret后需重启Replit项目，否则变量不会被注入运行环境。
• 变量名拼写错误：确认Replit中添加的Secret名称为OPENAI_API_KEY，大小写完全一致。

修复方案 #

• 将OpenAI相关代码移至服务端组件、API路由或Server Actions中，示例API路由写法：

// app/api/chat/route.ts
import OpenAI from 'openai';
import { NextResponse } from 'next/server';

const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
});

export async function POST(request: Request) {
  const chatCompletion = await openai.chat.completions.create({
    messages: [{ role: 'user', content: 'Say this is a test' }],
    model: 'gpt-3.5-turbo',
  });
  return NextResponse.json(chatCompletion);
}

• 重启Replit项目，确保Secret变量加载生效。
• 临时验证变量：在服务端代码中添加console.log(process.env.OPENAI_API_KEY)，查看终端输出是否有值（注意不要提交到代码仓库）。

错误2：Configuration不是构造函数 #

原因分析 #

你使用的是OpenAI Node.js SDK v4版本，但第二种写法属于v3版本的API规范。v4已移除Configuration和OpenAIApi类，统一使用OpenAI类初始化客户端。

修复方案 #

改用v4版本的标准写法，封装函数示例：

// utils/openai.ts
import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
});

export async function createChatCompletion(prompt: string) {
  const response = await openai.chat.completions.create({
    model: "gpt-3.5-turbo",
    messages: [
      {
        role: "user",
        content: prompt,
      },
    ],
  });
  return response;
}

注意：该工具函数仅能在服务端环境调用。

额外注意事项 #

• 禁止在客户端代码中处理OpenAI密钥，所有密钥相关逻辑必须放在服务端。
• 若需使用v3版本SDK，可执行npm install openai@3降级，但推荐使用最新v4版本。

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