为何npm run build编译阶段会尝试连接Elasticsearch地址？

Next.js执行npm run build（即next build）时，会对使用**静态生成（SSG）**的页面执行预渲染逻辑：

• 如果页面中定义了getStaticProps函数，这个函数会在构建阶段运行，用于获取数据生成静态HTML文件。
• 你的config/elasticsearch.js导出了一个已初始化的Elasticsearch客户端实例，一旦某个页面在getStaticProps（或模块加载阶段的其他代码）中导入并使用该客户端执行查询，构建过程就会尝试连接Elasticsearch地址elastic:9200。
• 另外，Elasticsearch客户端初始化本身不会立刻建立连接，但如果代码在模块级别（而非函数内部）执行了查询操作，页面模块被加载时也会触发连接请求。

从错误栈可以看到，触发连接的代码来自pages/doctors/[dynamic].js，说明这个动态页面在构建阶段执行了ES查询逻辑。

针对CI/CD环境构建时无法访问ES的场景，可采用以下几种方案：

1. 改用服务器端渲染（SSR）或增量静态再生（ISR） #

• 将页面数据获取逻辑从getStaticProps改为getServerSideProps，该函数仅在用户请求页面时运行，构建阶段不会执行，因此不会触发ES连接。
• 若仍需静态页面，可使用ISR（增量静态再生），通过revalidate参数让页面在构建后按需更新，构建阶段仅生成初始静态页面，后续更新时再连接ES。

2. 封装ES查询逻辑，避免模块级执行 #

• 不要在模块加载时直接执行ES查询，将查询逻辑封装成函数，仅在需要时（如getServerSideProps内部、API路由中）调用：

  // 修改config/elasticsearch.js
  var elasticsearch = require('elasticsearch');
  
  function createESClient() {
    return new elasticsearch.Client({
      host: 'elastic:9200',
    });
  }
  
  async function fetchHospitals() {
    const client = createESClient();
    const result = await client.search({
      index: 'lyfboat',
      type: 'hospitals',
      // 查询参数
    });
    return result;
  }
  
  module.exports = { fetchHospitals };
  

• 在页面中仅在运行时函数（如getServerSideProps）内部调用fetchHospitals，避免构建阶段执行。

3. CI构建阶段Mock ES数据 #

• 通过环境变量判断是否处于CI构建环境，返回Mock数据替代真实ES查询：

  // 页面的getStaticProps中
  export async function getStaticProps() {
    if (process.env.CI) {
      // 返回Mock数据，跳过ES连接
      return {
        props: { hospitals: [] },
        revalidate: 86400 // 可选：开启ISR后续更新
      };
    }
    // 正常环境下查询ES
    const { fetchHospitals } = require('../config/elasticsearch');
    const hospitals = await fetchHospitals();
    return { props: { hospitals } };
  }
  

4. 让CI环境可访问Elasticsearch #

• 在CI pipeline中启动Elasticsearch容器（如使用Docker），确保构建环境能解析elastic主机名并访问9200端口；
• 若ES服务部署在外部，将CI环境的网络配置为可访问该服务，并修改ES客户端的host为CI环境能访问的地址。

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