Express.js集成Knex.js调用AWS Secrets Manager执行顺序错乱问题求解

问题根因 #

• Node.js的CommonJS模块加载是同步执行的，你在knexfile中直接将connection字段赋值为getConfig()的返回值，这是一个未完成的Promise对象，模块不会等待异步请求完成就会导出配置。
• 你当前的knex.js中是同步初始化Knex实例，Knex加载时不会自动等待connection对应的Promise resolve，直接用Promise对象作为连接配置不生效，所以初始化流程会直接往下走，等AWS Secrets Manager的异步回调返回时，服务已经启动完成了。

修复方案 #

1. 补全AWS请求的错误处理 #

先修正knexfile.js中getConfig函数的错误逻辑，避免请求失败时出现未捕获的异常：

async function getConfig() {
  console.log("in get config")
  return await new Promise((resolve, reject) => {
    client.getSecretValue({ SecretId: secretName }, function (
      err,
      data
    ) {
      // 新增错误处理逻辑
      if (err) {
        return reject(err);
      }
      let secret = JSON.parse(data.SecretString);
      console.log("returning it***************" + secret.password + " " + secret.username + " " + pathToCert)
      let connectionString = `postgresql://${secret.username}:${secret.password}@some-host:1234/defaultdb?sslmode=verify-full&sslrootcert=${pathToCert}&options=--cluster`
      resolve(connectionString)
    })
  })
}

2. 调整Knex初始化逻辑为异步 #

修改knex.js，不再直接同步导出Knex实例，改为导出异步初始化方法，等待密钥获取完成后再初始化Knex：

console.log("knex.js")
const environment = process.env.APP_ENV || 'development'
const config = require('../knexfile.js')[environment];
let knexInstance = null;

async function initKnex() {
  if (knexInstance) return knexInstance;
  // 等待连接配置的Promise resolve完成
  const connectionStr = await config.connection;
  const finalConfig = {
    ...config,
    connection: connectionStr
  };
  knexInstance = require('knex')(finalConfig);
  return knexInstance;
}

module.exports = { initKnex };

3. 调整应用启动逻辑 #

修改app.js的启动流程，必须等待Knex初始化完成后再监听端口启动服务：

const { initKnex } = require('./path/to/knex.js');
// 其余依赖导入、路由配置逻辑保留

async function bootstrap() {
  // 先完成Knex初始化，拿到密钥后再执行后续流程
  const knex = await initKnex();
  // 可在这里添加数据库连通性校验逻辑
  // 其余初始化逻辑完成后，再启动端口监听
  app.listen(3000, () => {
    console.log('Listening on: 3000');
  })
}

// 捕获初始化阶段的异常
bootstrap().catch(err => {
  console.error('应用初始化失败：', err);
  process.exit(1);
});

验证效果 #

修改完成后重启服务，控制台输出顺序会符合预期，密钥获取成功后才会启动服务监听。

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