Flowise RAG流程Qdrant Upsert故障排查：PDF文件上传显示0 Added

一、API请求Payload检查 #

• 确保请求头Content-Type设置为multipart/form-data，上传文件必须用表单格式，application/json无法解析文件内容。
• 确认Postman中文件字段的参数名与FlowiseFile Upload节点的输入参数名一致（默认是file，自定义过需对应）。
• 测试无密码、未损坏的标准PDF文件，排除加密/损坏文件被加载器跳过的情况。

二、Flowise节点配置验证 #

• 检查Embedding节点（如OpenAI Embeddings）的API密钥是否有效，Embedding服务失败会导致向量无法生成，最终显示“0 Added”。
• 确认Vector DB节点（如Pinecone、Chroma）的连接参数（API密钥、索引名、环境）正确，数据库连接失败会导致向量无法写入。
• 检查PDF加载器节点（如PyPDFLoader）是否启用，且未设置过窄的过滤规则（如限定页码范围与测试文件不匹配）。

三、权限与日志排查 #

• 确认调用API使用的Flowise密钥拥有文件upsert权限，而非仅问答权限。
• 查看Flowise控制台或部署目录的日志文件，搜索“embedding failed”“database connection error”等关键词，定位具体失败原因。

四、Postman请求细节核对 #

• 在Postman Body表单中，文件字段需选择File类型，确保本地PDF文件被正确选中，避免路径错误或未加载文件。
• 若API需要额外参数（如collectionName），确认参数已添加到表单中，且值与Vector DB的集合名完全一致。

内容的提问来源于stack exchange，提问作者GOH YI QI