issue: .ino files fail to upload to knowledge with Tika as the extraction engine

问题场景

在 Open WebUI 的知识库（Knowledge）中上传 Arduino 开发环境生成的 .ino 文件，并将“内容提取引擎”（Content Extraction Engine）设置为 Tika 时，上传中断并弹出 JSON 解析错误。同一目录下的 .cpp 和 .h 文件均上传成功，唯独 .ino 文件失败。

报错原文

Expecting value: line 1 column 1 (char 0)

原因分析

根据 Issue 描述与日志走向，这个错误的根因并非 Open WebUI 本身，而是 Tika 不支持 .ino 扩展名。可能原因：Tika 在识别 .ino 文件时返回空响应或非 JSON 内容，Open WebUI 后端尝试解析返回结果时因内容为空而抛出 JSON 解码异常。与此同时，更换为默认提取引擎后文件可以正常上传，也佐证问题集中在 Tika 的文件类型处理上。

环境排查

• 确认 Open WebUI 版本为 V0.11.3（Docker 安装方式）。
• 确认内容提取引擎确实选择了 Tika（设置路径：管理员面板 → 文档设置 → 内容提取引擎）。
• 确认上传的扩展名为 .ino（Arduino 源文件），而非 .cpp 或 .h 文件。
• 检查服务端日志是否出现 Tika 相关错误或空响应记录。

解决步骤

1. 临时规避（已验证）：暂时切换到默认内容提取引擎上传 .ino 文件：进入 Open WebUI 管理面板，找到内容提取引擎设置，选择“默认”（Default），保存后重新上传文件。
2. 检查更新：前往 GitHub 查看 PR #29673 是否已合并，并检查新版本发布说明，确认是否包含文件处理修复。若已合并，可尝试升级 Open WebUI 版本后重新使用 Tika 上传。
3. 手动转换（可优先尝试）：若无法升级，将 .ino 文件扩展名改为 .txt 或 .cpp 后再上传到知识库（知识库内容本身不受影响，只是为了让 Tika 识别为支持的文本类型）。
4. 保持默认引擎：如果 .ino 文件是日常工作流的一部分，建议在该工作流中持续使用默认引擎；Tika 的修复版本未发布前不要切回。

验证方法

在完成上述步骤后，使用 Tika 作为提取引擎重新上传一个 .ino 文件。如果上传成功且能在知识库中检索到内容，说明问题已解决。若仍有报错，请回到管理面板确认引擎切换是否保存成功，并检查日志中是否有类似 JSON 解码错误的记录。

参考来源

open-webui/open-webui #29670

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。