本地Weaviate实例添加类租户失败,报404错误求助
问题分析与解决
你的本地Weaviate实例可以启用多租户,出现404错误的原因主要是以下两点:
1. Weaviate版本过低
多租户功能是在Weaviate v1.19.0版本正式引入的,如果你的本地实例版本低于这个版本,对应的API路径/v1/schema/{class}/tenants根本不存在,自然会返回404。
你可以通过以下方式检查版本:
- 命令行执行:
weaviate --version - 代码中获取:
print(client.get_meta()['version'])
如果版本低于v1.19.0,需要升级到最新稳定版。
2. 实例启动时未启用多租户功能
即使版本达标,多租户功能默认是关闭的,必须在启动Weaviate时通过环境变量显式开启:
- 如果你用Docker启动,需要在
docker-compose.yml中添加环境变量:
services: weaviate: image: semitechnologies/weaviate:latest environment: - ENABLE_MULTI_TENANCY=true # 保留其他原有环境变量(如AUTHENTICATION_APIKEY_ENABLED、PERSISTENCE_DATA_PATH等)
- 启动后,可通过API验证功能是否启用:访问
http://localhost:8080/v1/meta,查看返回结果中是否包含multiTenancy: true。
修复步骤
- 确认Weaviate版本≥v1.19.0
- 修改启动配置,添加
ENABLE_MULTI_TENANCY=true环境变量 - 重启Weaviate实例
- 重新运行你的代码,即可正常添加租户
内容的提问来源于stack exchange,提问作者Lizzard28
相关产品推荐
相关产品推荐

