使用weaviate-client连接WCS报错：connectToWCS不是函数

出现TypeError: weaviate.connectToWCS is not a function的核心原因是客户端版本与参考文档版本不匹配，具体分两种情况处理：

情况1：你安装的是v3版本weaviate-client（对应你参考的v3文档） #

v3版本客户端没有connectToWCS方法，需要用传统的客户端构造方式创建连接：

import weaviate from 'weaviate-client'

const search = async () => {
  const client = weaviate.client({
    scheme: 'https', // 根据你的WCS地址调整为http或https
    host: MY_WEAVIATE_URL, // 注意只填域名部分，比如xxx.weaviate.network，不要带http/https前缀
    apiKey: new weaviate.ApiKey(MY_API_KEY),
    headers: {
      'X-OpenAI-Api-Key': MY_OPENAI_API_KEY,
    }
  })

  // 可选：测试连接是否成功
  try {
    const meta = await client.misc.getMeta();
    console.log('连接成功，实例元数据:', meta);
  } catch (err) {
    console.error('连接失败:', err);
  }
}

search()

情况2：你安装的是v4版本weaviate-client（但误参考了v3文档） #

v4版本确实有connectToWCS方法，但导入方式和v3不同，需要按需导入：

import { connectToWCS, ApiKey } from 'weaviate-client'

const search = async () => {
  const client = await connectToWCS(
    MY_WEAVIATE_URL,
    {
      authCredentials: new ApiKey(MY_API_KEY),
      headers: {
        'X-OpenAI-Api-Key': MY_OPENAI_API_KEY,
      }
    }
  )

  console.log(client);
}

search()

如何确认客户端版本 #

查看项目根目录下的package.json文件，找到weaviate-client对应的版本号；或者在终端执行命令：

npm list weaviate-client

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