TypeScript跨文件共享可变全局变量的实现问题求助

你遇到的核心问题是异步初始化的时序问题：setup.ts里的startUp是异步函数，数据库查询属于异步操作，即便你让setup先运行，example.ts的代码很可能在数据库请求完成、变量赋值之前就执行了，所以拿到的还是类静态属性的初始undefined值。

下面是一套能保证全局变量正确共享、异步初始化时序可控的方案：

1. 改造SysParam类（SysParam.ts） #

增加初始化状态追踪，同时封装初始化逻辑，避免重复请求数据库：

export class SysParam {
  // 私有静态变量存储实际值
  private static _domain: string | undefined;
  private static _env: string | undefined;
  // 标记是否已经初始化完成
  private static _isInitialized = false;
  // 存储初始化Promise，避免重复触发数据库请求
  private static _initPromise: Promise<void> | null = null;

  // 对外暴露的getter，确保只有初始化完成后才返回有效值
  public static get domain(): string {
    if (!this._isInitialized) {
      throw new Error("SysParam尚未初始化，请先调用init()方法");
    }
    return this._domain!;
  }

  public static get env(): string {
    if (!this._isInitialized) {
      throw new Error("SysParam尚未初始化，请先调用init()方法");
    }
    return this._env!;
  }

  // 初始化方法，封装数据库查询逻辑，确保只执行一次
  public static async init(): Promise<void> {
    // 如果已经初始化过，直接返回
    if (this._isInitialized) return;
    // 如果正在初始化中，返回同一个Promise，避免重复请求
    if (this._initPromise) return this._initPromise;

    try {
      this._initPromise = (async () => {
        // 这里替换成你的数据库查询逻辑
        const result = await yourDatabaseQueryFunction();
        this._domain = result.recordset[0].domain;
        this._env = result.recordset[0].env;
        this._isInitialized = true;
      })();

      await this._initPromise;
    } finally {
      this._initPromise = null;
    }
  }

  // 按需更新变量的方法（如果需要动态修改）
  public static updateParams(newDomain: string, newEnv: string): void {
    this._domain = newDomain;
    this._env = newEnv;
    this._isInitialized = true; // 更新后标记为已初始化
  }
}

2. 改造初始化逻辑（setup.ts） #

现在不需要单独的startUp函数，直接调用SysParam.init()即可：

// setup.ts
import { SysParam } from './SysParam';

// 在应用启动时调用初始化
export async function bootstrap() {
  await SysParam.init();
  console.log("初始化完成，domain:", SysParam.domain);
}

3. 全局使用示例（example.ts） #

在任何需要使用参数的地方，确保先等待初始化完成，或者在初始化完成后再执行代码：

// example.ts
import { SysParam } from './SysParam';
import { bootstrap } from './setup';

// 方式1：在应用入口先完成初始化，再执行后续逻辑
async function main() {
  await bootstrap();
  console.log("从example.ts获取domain:", SysParam.domain);
  // 这里执行你的业务逻辑
}

main().catch(err => console.error("应用启动失败:", err));

// 方式2：如果是在某个异步业务函数中使用，确保先检查初始化状态
async function someBusinessLogic() {
  await SysParam.init(); // 这里调用会自动判断是否已经初始化
  console.log("业务逻辑中获取domain:", SysParam.domain);
}

关键要点说明 #

• 异步时序控制：通过init()方法返回Promise，确保所有使用参数的代码都等待初始化完成后再执行，从根源上避免undefined的问题。
• 避免重复请求：通过_initPromise和_isInitialized标记，确保多次调用init()也只会执行一次数据库查询。
• 类型安全：使用TypeScript的非空断言!配合初始化检查，保证getter返回的一定是有效值，避免类型报错。
• 动态更新支持：提供updateParams方法，支持后续按需修改参数值，同时保持全局一致性。

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