Next.js中如何实现跨路由可共享的全局变量？

问题核心 #

你遇到的问题本质是模块间未正确共享变量实例，或是单例类实现存在错误，导致每次访问都生成了新的变量/实例，而非复用同一个全局状态。

解决方案 #

方案1：利用模块导出直接共享变量（最简实现） #

Node.js模块默认是单例缓存机制，只要正确导出和导入，就能实现变量在多模块间共享：

1. 改造api/variable.ts，导出变量及操作方法：

// api/variable.ts
let test = 0;

export const setTest = (value: number) => {
  test = value;
};

export const getTest = () => {
  return test;
};

2. 在路由模块中导入使用：

// api/example1.ts
import { setTest } from './variable';

// 示例路由处理逻辑
export const example1Handler = () => {
  setTest(2);
};

// api/example2.ts
import { getTest } from './variable';

// 示例路由处理逻辑
export const example2Handler = () => {
  return getTest(); // 调用setTest后会返回2
};

方案2：正确实现单例类 #

如果要用单例类，必须保证构造函数私有，且通过静态方法获取唯一实例，避免重复创建：

// api/variable.ts
class GlobalStore {
  private static instance: GlobalStore;
  private test: number = 0;

  // 私有构造函数，禁止外部直接实例化
  private constructor() {}

  // 全局唯一获取实例的入口
  public static getInstance(): GlobalStore {
    if (!GlobalStore.instance) {
      GlobalStore.instance = new GlobalStore();
    }
    return GlobalStore.instance;
  }

  public setTest(value: number): void {
    this.test = value;
  }

  public getTest(): number {
    return this.test;
  }
}

export default GlobalStore;

在路由中使用：

// api/example1.ts
import GlobalStore from './variable';

export const example1Handler = () => {
  const store = GlobalStore.getInstance();
  store.setTest(2);
};

// api/example2.ts
import GlobalStore from './variable';

export const example2Handler = () => {
  const store = GlobalStore.getInstance();
  return store.getTest();
};

方案3：多进程/Serverless环境下的全局状态 #

如果服务部署在多进程集群或**Serverless（如Vercel、AWS Lambda）**环境中，内存中的全局变量无法跨进程共享，此时需要依赖外部存储：

• 使用Redis等内存数据库存储全局变量
• 使用MySQL、MongoDB等数据库持久化状态

关键注意事项 #

• 确保所有模块导入的是同一个variable.ts文件（注意相对路径正确性，避免因路径错误加载不同模块）
• 单例类必须保证构造函数私有，且仅通过getInstance获取实例
• 无状态部署环境下，内存变量无法跨请求共享，必须依赖外部存储

内容的提问来源于stack exchange，提问作者Fábio Morais