[Bug]gemini知识库存储失败

[7618104m]

What happened / 发生了什么

在我使用嵌入模型gemini的embedding时
提示：
[2026-04-25 18:52:04.548] [Core] [WARN] [v4.23.5] [knowledge_base.kb_helper:440]: 上传文档失败: 存储失败：文本块已生成，但写入知识库索引时出错。
[2026-04-25 18:52:04.549] [Core] [ERRO] [v4.23.5] [routes.knowledge_base:197]: 上传文档 ***.txt 失败: 存储失败：文本块已生成，但写入知识库索引时出错。
我尝试了gemini-embedding-2与gemini-embedding-001均出现同样的错误
批处理设置与分块设置也改动过，但依旧不行
来来回回尝试了几小时........

Reproduce / 如何复现？

1.创建gemini的嵌入模型
2.随便选择gemini-embedding-2或gemini-embedding-001
3.创建知识库
4.上传文件

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

v4.23.5桌面

OS

Windows

Logs / 报错日志

[2026-04-25 18:45:37.933] [Core] [WARN] [v4.23.5] [knowledge_base.kb_helper:440]: 上传文档失败: 存储失败：文本块已生成，但写入知识库索引时出错。
[2026-04-25 18:45:37.934] [Core] [ERRO] [v4.23.5] [routes.knowledge_base:197]: 上传文档 ****.txt 失败: 存储失败：文本块已生成，但写入知识库索引时出错。
[2026-04-25 18:47:08.424] [Core] [WARN] [v4.23.5] [knowledge_base.kb_helper:440]: 上传文档失败: 存储失败：文本块已生成，但写入知识库索引时出错。
[2026-04-25 18:47:08.424] [Core] [ERRO] [v4.23.5] [routes.knowledge_base:197]: 上传文档 ****.txt 失败: 存储失败：文本块已生成，但写入知识库索引时出错。
[2026-04-25 18:49:04.153] [Core] [WARN] [v4.23.5] [knowledge_base.kb_helper:440]: 上传文档失败: 存储失败：文本块已生成，但写入知识库索引时出错。
[2026-04-25 18:49:04.153] [Core] [ERRO] [v4.23.5] [routes.knowledge_base:197]: 上传文档 ****.txt 失败: 存储失败：文本块已生成，但写入知识库索引时出错。

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

这个错误 "文本块已生成，但写入知识库索引时出错" 实际上是一个通用的异常包装，隐藏了底层真正的失败原因 [1]。根据代码分析，最可能的原因是嵌入维度不匹配。

关键信息：

1. AstrBot 的 Gemini 嵌入提供者默认维度为 768，且配置提示"请务必填写正确，否则将导致向量数据库无法正常工作" [2]。如果创建知识库时的维度设置与实际嵌入模型返回的维度不一致，写入 FAISS 索引时就会失败 [3]。

2. AstrBot 默认使用的是 gemini-embedding-exp-03-07 模型 [4]，而你使用的是 gemini-embedding-2 或 gemini-embedding-001，这些模型的维度可能与默认配置不同。

建议排查步骤：

• 检查维度配置：在面板的嵌入模型设置中，确认配置的维度值与你使用的 Gemini 模型实际输出的维度一致。可以通过面板的维度检测功能 (/config/provider/get_embedding_dim) 自动检测正确维度 [5]。
• 重新创建知识库：如果维度配置有误，需要在修正维度后删除并重新创建知识库，因为已有的 FAISS 索引维度无法更改。
• 查看完整日志：当前错误信息掩盖了底层异常，如果日志中有更详细的 traceback 信息，可以贴出来帮助进一步定位。

之前的 #7589 也遇到过类似的知识库上传问题，PR #7534 增加了更严格的校验逻辑 [6]，你看到的这个错误很可能就是其中某项校验（如维度检查）失败后被包装成了这个通用提示。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[7618104m]

这个错误 "文本块已生成，但写入知识库索引时出错" 实际上是一个通用的异常包装，隐藏了底层真正的失败原因 [1]。根据代码分析，最可能的原因是嵌入维度不匹配。

关键信息：

1. AstrBot 的 Gemini 嵌入提供者默认维度为 768，且配置提示"请务必填写正确，否则将导致向量数据库无法正常工作" [2]。如果创建知识库时的维度设置与实际嵌入模型返回的维度不一致，写入 FAISS 索引时就会失败 [3]。
2. AstrBot 默认使用的是 gemini-embedding-exp-03-07 模型 [4]，而你使用的是 gemini-embedding-2 或 gemini-embedding-001，这些模型的维度可能与默认配置不同。

建议排查步骤：

• 检查维度配置：在面板的嵌入模型设置中，确认配置的维度值与你使用的 Gemini 模型实际输出的维度一致。可以通过面板的维度检测功能 (/config/provider/get_embedding_dim) 自动检测正确维度 [5]。
• 重新创建知识库：如果维度配置有误，需要在修正维度后删除并重新创建知识库，因为已有的 FAISS 索引维度无法更改。
• 查看完整日志：当前错误信息掩盖了底层异常，如果日志中有更详细的 traceback 信息，可以贴出来帮助进一步定位。

之前的 #7589 也遇到过类似的知识库上传问题，PR #7534 增加了更严格的校验逻辑 [6]，你看到的这个错误很可能就是其中某项校验（如维度检查）失败后被包装成了这个通用提示。

To reply, just mention @dosu.

Share context across your team and agents. Try Dosu.

自动检测、重新创建等等，我之前也试过
至于更详细的日志
日志中似乎并没有这一类的信息

[dosubot]

找到了日志中没有详细 traceback 的原因——这是代码中的一个日志缺陷。

在 kb_helper.py 的外层异常处理中 [1]，对于 KnowledgeBaseUploadError 类型的异常，只用了 logger.warning(f"上传文档失败: {e}")，没有传入 exc_info=True，所以底层真正的异常原因不会被打印。而 KnowledgeBaseUploadError.__str__() 也只返回用户友好的消息，不包含原始异常信息 [2]。

临时排查方法：你可以手动修改 astrbot/core/knowledge_base/kb_helper.py，找到约第 439 行的：

if isinstance(e, KnowledgeBaseUploadError):
    logger.warning(f"上传文档失败: {e}", extra={"details": e.details})

改为：

if isinstance(e, KnowledgeBaseUploadError):
    logger.warning(f"上传文档失败: {e}", extra={"details": e.details})
    if e.__cause__:
        logger.error(f"底层异常: {e.__cause__}", exc_info=(type(e.__cause__), e.__cause__, e.__cause__.__traceback__))

然后重新上传文件，日志中就会出现真正的错误原因。

可能的底层原因：Gemini 嵌入提供者只 catch 了 APIError，如果 Gemini API 返回了空的嵌入结果或 None 值，代码中的 assert 会抛出 AssertionError/IndexError，这些异常不会被 provider 捕获，最终被 kb_helper 的通用 wrapper 吞掉 [3]。

拿到底层异常信息后可以贴在这里，方便进一步定位。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[7618104m]

可以了
但是之后出现了（用户名是中文）
桌面版不能改存储路径
不过我自己把他搬到了e盘