解决Chatbot-UI与Supabase自托管Docker集成中的文件检索问题

问题背景

在使用自托管Docker方式部署Supabase并与Chatbot-UI集成时，用户可能会遇到文件上传成功但无法在聊天过程中检索的问题。具体表现为：文件上传操作看似成功完成，但当尝试与上传的文件进行交互时，系统返回500内部服务器错误，且错误信息不够明确。

问题诊断

通过开发者工具检查网络请求，可以发现当调用检索接口时，服务端返回了非描述性的错误信息："An unexpected error occurred"。为了获取更详细的错误信息，我们可以修改Chatbot-UI的源代码：

1. 定位到app/api/retrieval/retrieve/route.ts文件
2. 修改错误处理逻辑，使其返回完整的错误对象而非简化的错误信息

修改后重新测试，系统返回了更详细的错误信息，显示PostgreSQL操作符不存在的问题：

{
  "code": "42883",
  "details": null,
  "hint": "No operator matches the given name and argument types. You might need to add explicit type casts.",
  "message": "operator does not exist: extensions.vector <=> extensions.vector"
}

这个错误表明PostgREST服务无法正确处理向量扩展相关的操作，因为默认配置下它没有包含extensions模式在搜索路径中。

解决方案

1. 检查向量扩展

首先确保Supabase数据库中已启用vector扩展：

1. 登录Supabase管理界面
2. 导航到数据库 → 扩展
3. 确认vector扩展已启用

2. 配置PostgREST搜索路径

修改Supabase的Docker Compose配置，为PostgREST服务添加额外的搜索路径：

1. 编辑docker-compose.yml文件，在rest服务部分添加环境变量：

environment:
  PGRST_DB_EXTRA_SEARCH_PATH: ${PGRST_DB_EXTRA_SEARCH_PATH}

2. 在Supabase的.env配置文件中添加：

PGRST_DB_EXTRA_SEARCH_PATH=public,extensions

3. 重启服务

应用配置更改后，需要重启Supabase服务：

docker compose stop && docker compose up -d

技术原理

PostgREST是Supabase提供的RESTful API服务，它将PostgreSQL数据库直接暴露为REST API。默认情况下，PostgREST只会在public模式中查找表和函数。当使用vector等扩展时，这些扩展通常安装在extensions模式中。

通过设置PGRST_DB_EXTRA_SEARCH_PATH环境变量，我们告诉PostgREST服务在解析SQL查询时，除了默认的public模式外，还应该检查extensions模式。这样就能正确解析向量扩展提供的操作符和函数。

验证解决方案

实施上述修改后，可以验证问题是否解决：

1. 上传新的测试文件
2. 尝试与文件进行交互
3. 检查开发者工具中的网络请求，确认不再出现500错误
4. 确认能够正常获取文件内容进行聊天交互

总结

在自托管Supabase环境中集成Chatbot-UI时，正确处理PostgreSQL扩展的访问权限是关键。通过适当配置PostgREST的搜索路径，可以解决因扩展操作符不可见导致的检索问题。这种配置方式不仅适用于vector扩展，也适用于其他可能需要从非默认模式访问的PostgreSQL扩展。