Node.js应用如何仅启动时调用API一次获取凭据并支持全局导入复用

Node.js 原生的模块缓存机制本身就可以满足「仅请求一次API」的需求，模块只会在首次被导入时执行一次代码，后续所有导入都会复用第一次的导出结果，不需要自己额外实现单例逻辑。

方案1：ESM 规范（Node.js 14.8+ 支持，最简洁） #

直接在creds.js的顶层发起API请求，用顶层await等待请求完成后再导出即可：

// creds.js
// 发起API请求，仅会在模块首次加载时执行一次
const fetchCreds = async () => {
  const res = await fetch('你的凭据API地址')
  if (!res.ok) throw new Error('凭据拉取失败')
  const apiCreds = await res.json()
  // 可在此处合并硬编码/环境变量默认值
  return {
    key: apiCreds.key || process.env.KEY || 'diqndwqn',
    id: apiCreds.id || process.env.ID || 'dqw2231qzaxc',
    db: {
      user: apiCreds.dbUser || 'dqdwmkovvoij',
      pw: apiCreds.dbPw || 'ofo9v8#$w'
    }
  }
}

// 顶层await等待请求完成，导出的是最终凭据对象，非Promise
export default await fetchCreds()

使用时直接导入即可，和原有用法几乎无差异：

// 其他业务模块
import creds from './creds.js'
console.log(creds.key) // 直接拿到值，无需await

方案2：CommonJS 规范兼容方案 #

CommonJS 不支持顶层await，可导出已初始化的Promise，Promise状态敲定后复用不会重新执行逻辑，也不会重复发起请求：

// creds.js
// Node.js <18 版本需先安装node-fetch依赖
const fetch = require('node-fetch')

const fetchCreds = async () => {
  const res = await fetch('你的凭据API地址')
  if (!res.ok) throw new Error('凭据拉取失败')
  const apiCreds = await res.json()
  // 合并默认值逻辑同上
  return {
    key: apiCreds.key || process.env.KEY || 'diqndwqn',
    id: apiCreds.id || process.env.ID || 'dqw2231qzaxc',
    db: {
      user: apiCreds.dbUser || 'dqdwmkovvoij',
      pw: apiCreds.dbPw || 'ofo9v8#$w'
    }
  }
}

// 直接执行请求，导出Promise实例，仅会执行一次
module.exports = fetchCreds()

使用时在导入处await即可：

// 其他业务模块
const credsPromise = require('./creds.js')

async function yourBusinessLogic() {
  const creds = await credsPromise
  console.log(creds.db.user)
}

如果不想在业务代码中重复加await，可以在服务启动入口先等待凭据拉取完成再启动服务：

// 服务启动入口 index.js
const credsPromise = require('./creds.js')
const startServer = require('./server.js')

async function bootstrap() {
  await credsPromise // 等待凭据拉取完成
  startServer() // 启动服务后，所有模块导入的凭据Promise都已敲定，await会立刻返回值
}
bootstrap()

可选优化点 #

• 可在fetchCreds函数中加入请求重试逻辑，避免单次网络波动导致凭据拉取失败
• 可将API请求地址、重试次数等配置放到环境变量中，方便不同环境切换

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