如何在NodeJS项目启动时自动运行Liquibase数据库迁移？

很高兴看到你已经入门Liquibase并想把它集成到Node.js项目的启动流程里！这里有几个实用的方案，你可以根据自己的项目情况灵活选择：

这是最直接的方式，不需要额外写代码，只需要修改package.json的脚本配置：

1. 先在scripts里添加一个专门的迁移命令：

   {
     "scripts": {
       "db:migrate": "liquibase update",
       "start": "npm run db:migrate && node ./src/index.js"
     }
   }
   

   这里假设你的Liquibase已经配置好liquibase.properties（或者用命令行参数指定数据库连接、变更日志等信息），入口文件是./src/index.js。

2. 每次启动项目时，直接运行npm start，系统会先执行Liquibase迁移，只有迁移成功后才会启动Node.js服务——这其实是个好习惯，避免服务连接到未更新的数据库。如果想让迁移失败时仍强制启动服务（不推荐，但特殊场景可用），可以把命令改成：

   "start": "npm run db:migrate || node ./src/index.js"
   

如果需要更精细的控制（比如根据环境变量切换配置、迁移完成后执行自定义操作），可以用Node.js的child_process模块直接调用Liquibase命令：

const { execSync } = require('child_process');
const path = require('path');

async function runDatabaseMigrations() {
  try {
    console.log('🔍 开始执行数据库迁移...');
    
    // 根据环境变量切换Liquibase配置（示例）
    const liquibaseArgs = process.env.NODE_ENV === 'production'
      ? '--changeLogFile=changelog-prod.xml --defaultsFile=liquibase-prod.properties update'
      : '--changeLogFile=changelog-dev.xml --defaultsFile=liquibase-dev.properties update';
    
    // 执行迁移，把Liquibase的输出直接同步到控制台
    execSync(`liquibase ${liquibaseArgs}`, { 
      stdio: 'inherit',
      cwd: path.resolve(__dirname, './liquibase') // 如果Liquibase配置文件在子目录里
    });

    console.log('✅ 数据库迁移执行完成！');
  } catch (error) {
    console.error('❌ 数据库迁移失败:', error.message);
    // 迁移失败时终止服务启动（可选，根据业务需求调整）
    process.exit(1);
  }
}

// 先执行迁移，再启动服务
runDatabaseMigrations().then(() => {
  const app = require('./src/app');
  const port = process.env.PORT || 3000;
  
  app.listen(port, () => {
    console.log(`🚀 服务已启动，监听端口 ${port}`);
  });
});

如果你的项目用PM2管理进程，可以在PM2的配置文件里指定启动前的迁移命令：

// ecosystem.config.js
module.exports = {
  apps: [{
    name: 'your-node-app',
    script: './src/index.js',
    exec_pre: 'liquibase update', // 启动服务前先执行迁移
    env: {
      NODE_ENV: 'development'
    },
    env_production: {
      NODE_ENV: 'production'
    }
  }]
};

之后用pm2 start ecosystem.config.js启动时，PM2会自动先执行Liquibase迁移，再启动你的Node.js服务。

• 确保Liquibase可以被调用：如果不想全局安装Liquibase，可以安装npm包liquibase-cli，然后用npx liquibase代替直接写liquibase命令。
• 环境隔离：开发、测试、生产环境的数据库配置和变更日志要分开，避免误操作生产数据。
• 迁移幂等性：确保你的Liquibase ChangeSet是可重复执行的（比如用preConditions判断对象是否存在），避免重复创建表或插入数据。

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