[AstrBot] 知识库上传时 429: 超限\104:权限 报错

429报错

[2026-02-25 13:59:49.462] [Core] [ERRO] [v4.18.1] [routes.knowledge_base:190]: 上传文档 test.txt 失败：有 2 个批次处理失败：批次 2 处理失败，已重试 3 次：Error code: 429 - {'code': 429, 'reason': 'RATE_LIMIT_EXCEEDED', 'message': 'You have exceeded the request rate limit. Please wait a short period before retrying your request or contact the support to increase your request rate limit.', 'metadata': {'detail': 'current limit 5 requests per minute'}}; 批次 3 处理失败，已重试 3 次：Error code: 429 - {'code': 429, 'reason': 'RATE_LIMIT_EXCEEDED', 'message': 'You have exceeded the request rate limit. Please wait a short period before retrying your request or contact the support to increase your request rate limit.', 'metadata': {'detail': 'current limit 5 requests per minute'}}

429报错是因为超过了LLM模型的频率限制，在示例中，具体就是：current limit 5 requests per minute，当前限制为每分钟5次请求。

解决办法：

1、可以更换更强大的嵌入模型，示例中这个只能每分钟5次请求就是太少了，更换一个更强大的模型就能每分钟请求更多。

2、可以调整参数和切割文本，首先可以切割文本，利用在线切割工具等将txt文件等分割成一定数量的小份，分别来上传。然后还可以调整下参数，如下图：

像我刚开始用的这个模型，每分钟限制请求5次，这里就可以把批处理大小调整到1~5，我选择了3。最大重试次数也建议提高，比如说调整到6、8、10等。

因为这个模型请求次数太少了，所以我在切割了文本+调整了参数后也有几次上传失败，重试后成功上传。

104报错

上传文档 test.txt 失败: Error in __cdecl faiss::FileIOWriter::FileIOWriter(const char *) at D:\a\faiss-wheels\faiss-wheels\third-party\faiss\faiss\impl\io.cpp:104: Error: 'f' failed: could not open C:\Users\毛毛\.astrbot_launcher\instances\2229fdd5-c2ef-4c2b-9b7f-be1171c0941d\core\data\knowledge_base\8bd50007-

104报错是因为faiss向量数据库无法访问目标地址。

解决办法：

博主这里是因为用户名是中文的，所以导致路径中有中文，无法访问。新建了个Windows用户改成了英文名就可以了。（碎碎念：很久以前留下的问题了，一直想改但是又嫌麻烦，终于遇到了用户名导致的中文路径问题了呢…）