Next.js 13集成OpenAI 4.0包构建时出现私有标识符错误

问题描述 #

在 Next.js 项目中仅在服务端引入了 OpenAI 4.0 版本包，执行构建时出现编译失败，错误信息如下：

- info Linting and checking validity of types .Failed to compile.

./node_modules/openai/src/core.ts:539:3
Type error: Private identifiers are only available when targeting ECMAScript 2015 and higher.

  537 |
  538 | export abstract class AbstractPage<Item> implements AsyncIterable<Item> {
> 539 |   #client: APIClient;
      |   ^
  540 |   protected options: FinalRequestOptions;
  541 |
  542 |   protected response: Response;

已尝试修改 tsconfig.json 中的 target 配置为 es6、es2015、esnext，且开启了 skipLibCheck 选项，但问题仍未解决。当前 tsconfig.json 配置如下：

{
  "compilerOptions": {
    "target": "es5",
    "lib": [
      "dom",
      "dom.iterable",
      "esnext"
    ],
    "allowJs": true,
    "skipLibCheck": true,
    "strict": true,
    "forceConsistentCasingInFileNames": true,
    "noEmit": true,
    "esModuleInterop": true,
    "module": "esnext",
    "moduleResolution": "node",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "jsx": "preserve",
    "incremental": true,
    "plugins": [
      {
        "name": "next"
      }
    ],
    "paths": {
      "$/*": [
        "./src/*"
      ],
      "$app/*": [
        "./src/app/*"
      ],
      "$cmp/*": [
        "./src/components/*"
      ],
      "$types/*": [
        "./src/types/*"
      ],
      "$assets/*": [
        "./src/assets/*"
      ],
      "$lib/*": [
        "./src/lib/*"
      ]
    }
  },
  "include": [
    "next-env.d.ts",
    "**/*.ts",
    "**/*.tsx",
    ".next/types/**/*.ts"
  ],
  "exclude": [
    "node_modules"
  ]
}

解决方案 #

1. 确保 TypeScript 目标版本正确配置 #

首先确认 tsconfig.json 中的 target 确实设置为 es2015 或更高版本（当前配置显示为 es5，可能是修改后未保存或未生效）：

"compilerOptions": {
  "target": "es2015", // 替换为 es2015、es6 或 esnext
  // 其他配置保持不变
}

2. 让 Next.js 转译 OpenAI 包 #

OpenAI 4.0 的源码使用了未转译的 ES2015+ 特性（如私有标识符 #），Next.js 默认不会转译 node_modules 中的依赖，因此即使 skipLibCheck 开启，编译时仍会触发语法错误。此时需要在 next.config.js 中配置 transpilePackages，让 Next.js 转译 OpenAI 包：

/** @type {import('next').NextConfig} */
const nextConfig = {
  transpilePackages: ['openai'],
}

module.exports = nextConfig

3. 检查多配置文件冲突 #

如果项目中存在多个 TypeScript 配置文件（如 tsconfig.server.json），需确认这些文件的 target 也设置为 ES2015+，避免服务端代码编译时使用旧的目标版本。

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