Next.js服务端：如何共享instrumentation.ts获取的全局运行时配置？

不用Node的global变量，最简洁且符合Next.js最佳实践的方案是利用模块级变量封装配置，配合instrumentation.ts完成初始化。核心思路是：用一个单独的服务器模块存储配置，在服务器启动时通过instrumentation.ts完成动态拉取，其他服务端代码直接导入该模块获取配置。

具体实现步骤 #

1. 创建配置封装模块

新建lib/server-config.ts，负责存储配置、提供初始化和获取方法：

// 定义配置类型（TypeScript可选，增强类型安全）
type ServerConfig = {
  apiKey: string;
  appName: string;
  // 其他配置字段
};

let serverConfig: ServerConfig | null = null;

// 初始化配置：在这里写动态获取逻辑（比如调用远程API、读取数据库）
export async function initializeServerConfig() {
  // 示例：从远程配置中心拉取
  const res = await fetch('https://your-config-service.com/server-config');
  serverConfig = await res.json();
}

// 获取配置：确保只有初始化后才能调用
export function getServerConfig() {
  if (!serverConfig) {
    throw new Error('服务器配置未初始化，请检查 instrumentation.ts 中是否调用了 initializeServerConfig');
  }
  return serverConfig;
}

2. 在 instrumentation.ts 中初始化配置

修改instrumentation.ts（Next.js 13+ App Router 支持，Pages Router 需升级或用其他启动钩子）：

import { initializeServerConfig } from './lib/server-config';

export async function register() {
  // 服务器启动时执行一次，完成配置拉取
  await initializeServerConfig();
}

3. 在API路由和服务端组件中使用配置

• API路由（比如app/api/user/route.ts）：

import { getServerConfig } from '@/lib/server-config';
import { NextResponse } from 'next/server';

export async function GET() {
  const config = getServerConfig();
  // 使用配置调用第三方API
  const apiRes = await fetch(`https://api.example.com/data?key=${config.apiKey}`);
  const data = await apiRes.json();
  return NextResponse.json(data);
}

• 服务端组件（比如app/dashboard/page.tsx）：

import { getServerConfig } from '@/lib/server-config';

export default async function Dashboard() {
  const config = getServerConfig();
  return (
    <div>
      <h1>{config.appName} 控制台</h1>
      {/* 其他服务端渲染内容 */}
    </div>
  );
}

方案优势 #

• 避免全局污染：模块级变量仅在服务器端可见，不会污染全局命名空间
• 类型安全：用TypeScript可定义配置类型，减少运行时错误
• 符合Next.js生命周期：instrumentation.ts是官方推荐的服务器启动钩子，确保配置在所有服务端代码执行前完成初始化
• 隔离性：配置逻辑集中管理，便于后续修改或扩展（比如添加缓存、配置更新机制）

注意事项 #

• 该方案仅适用于服务端代码（API路由、服务端组件、Server Actions），客户端组件无法访问（也不应该暴露敏感配置给客户端）
• 多进程部署时（比如PM2启动多个进程），每个进程会独立执行初始化逻辑，若需共享配置可考虑外部缓存（如Redis）
• 配置仅在服务器启动时加载，若需热更新配置需额外实现监听机制

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