Docker化Elasticsearch 8.6.0与Node.js(TypeScript)连接失败问题

问题核心原因 #

1. 容器网络访问错误：Node.js服务运行在back容器内，代码里用localhost:9200会指向容器自身的localhost，而非Elasticsearch容器。Docker Compose服务间需通过服务名访问，Elasticsearch的服务名是es01。
2. SSL证书未配置：Elasticsearch开启了HTTPS并使用自签名CA证书，客户端需信任该证书才能建立连接。

修复步骤 #

1. 修改Node.js连接配置 #

更新客户端初始化代码，替换访问地址并添加SSL证书配置：

import { Client } from '@elastic/elasticsearch'
import * as fs from 'fs'

const client = new Client({
    node: 'https://es01:9200', // 替换为Elasticsearch服务名
    auth: {
        username: 'elastic',
        password: 'elastic_pass' // 确保与.env中的ELASTIC_PASSWORD一致
    },
    ssl: {
        // 读取容器内挂载的CA证书
        ca: fs.readFileSync('/usr/share/elasticsearch/config/certs/ca/ca.crt', 'utf8')
    }
})

// 接口添加错误处理便于排查问题
this.app.post('/testElastic', async (req, res) => {
    try {
        const result = await client.index({
            index: 'index-test',
            document: {
                character: 'Ned Stark',
                quote: 'Winter is coming.'
            }
        })
        res.status(200).json({ success: true, data: result })
    } catch (error) {
        res.status(500).json({ success: false, error: error.message })
    }
})

2. 更新Docker Compose配置 #

给back服务添加证书卷挂载，让容器能访问Elasticsearch的CA证书：

back:
    build: ./back
    restart: unless-stopped
    ports:
      - 3000:3000
    volumes:
      - ./back:/back
      - /back/node_modules
      - certs:/usr/share/elasticsearch/config/certs # 新增证书卷挂载
    depends_on:
      - es01
      - kibana
    container_name: Alda_Back

3. 验证配置并重启服务 #

• 确认.env文件中的ELASTIC_PASSWORD与Node.js代码里的password完全匹配。
• 重启所有服务：docker-compose down && docker-compose up -d

额外排查技巧 #

若仍有连接问题，可进入back容器内部，执行以下命令验证网络和证书是否正常：

curl https://es01:9200 -u elastic:your_password --cacert /usr/share/elasticsearch/config/certs/ca/ca.crt

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