CouchDB-lucene与CouchDB连接失败，请求排查问题

问题背景 #

• 已安装版本：CouchDB 3.3.3、CouchDB-Lucene 2.2.0
• 配置的local.ini内容：

[httpd_global_handlers]
_fti = {couch_httpd_proxy, handle_proxy_req, <<"http://localhost:5984">>}

• 报错现象：访问http://localhost:5984/_fti时返回：

{
  "error": "not_found",
  "reason": "Database does not exist."
}

修改代理地址为http://127.0.0.1:5985或http://localhost:5985后问题依旧。

错误原因与解决步骤 #

• 代理地址指向错误（核心问题）
  初始配置把_fti的代理指向了CouchDB自身的端口5984，导致请求被转发回CouchDB——而CouchDB原生没有_fti端点，因此返回"数据库不存在"的错误。正确的代理地址应该指向CouchDB-Lucene的监听端口（默认5985）。

• 配置生效需重启CouchDB
  修改local.ini后必须重启CouchDB服务，否则新配置不会加载。确保修改后的配置为：

[httpd_global_handlers]
_fti = {couch_httpd_proxy, handle_proxy_req, <<"http://localhost:5985">>}

• 验证CouchDB-Lucene服务状态
  直接访问http://localhost:5985，若返回包含版本信息的JSON响应，说明服务正常；若无法访问，需排查CouchDB-Lucene的启动日志、端口占用情况，确保服务已正确启动。

• 遵循正确的请求路径格式
  /_fti并非独立可访问的端点，正确的请求格式需包含数据库、设计文档和索引信息，例如：

  http://localhost:5984/_fti/local/[你的数据库名]/_design/[设计文档名]/[索引名]
  

  直接访问/_fti本身不符合CouchDB-Lucene的请求规范，也会触发错误。

• 检查CouchDB-Lucene的反向配置
  打开CouchDB-Lucene的couchdb-lucene.ini，确保couchdb.url指向正确的CouchDB地址（如http://localhost:5984/），且CouchDB用户拥有足够权限让CouchDB-Lucene访问目标数据库。

内容的提问来源于stack exchange，提问作者Ali