CouchDB 1.x升级至3.x后，如何迁移适配.couch格式旧数据文件

我完全懂你现在的糟心情况——系统更新误删了稳定运行的旧CouchDB，装了3.x后却没法直接用原来的1.x数据，连官方指南里的复制方法都用不了（因为旧服务已经没了）。别慌，咱们可以通过临时部署2.x版本做中转的方式来转换数据，步骤如下：

第一步：准备工作，确保数据安全 #

1. 先停掉当前运行的CouchDB 3.x服务，避免操作数据目录时冲突：

   sudo systemctl stop couchdb
   

2. 备份当前的CouchDB数据目录，以防操作失误丢数据：

   sudo cp -r /var/lib/couchdb /var/lib/couchdb_backup_$(date +%Y%m%d)
   

3. 确认旧的.couch文件（包括对应的._design.*文件）都在/var/lib/couchdb目录下，并且调整文件权限为CouchDB运行用户所有：

   sudo chown -R couchdb:couchdb /var/lib/couchdb/*.couch
   sudo chown -R couchdb:couchdb /var/lib/couchdb/._design.*
   

第二步：用CouchDB 2.x临时升级数据格式 #

CouchDB 3.x不直接兼容1.x的文件，但2.x可以自动把1.x的数据升级到兼容格式，我们用Docker快速部署一个2.x实例来做中转：

1. 启动CouchDB 2.3.1容器，挂载你的旧数据目录：

   sudo docker run -d -p 5984:5984 -v /var/lib/couchdb:/opt/couchdb/data --name couchdb2 couchdb:2.3.1
   

2. 等1-2分钟容器启动完成，用curl验证服务运行并确认旧数据库已被识别：

   curl http://localhost:5984/_all_dbs
   

   这个命令会返回所有存在的数据库列表，你应该能看到原来的数据库名称。

第三步：把2.x的数据复制到3.x实例 #

1. 启动你的CouchDB 3.x服务：

   sudo systemctl start couchdb
   

2. 给3.x设置管理员账号（3.x默认强制认证，必须先设置）：

   curl -X PUT http://localhost:5984/_users/org.couchdb.user:admin -d '{
     "name":"admin",
     "password":"your_secure_password",
     "roles":[],
     "type":"user"
   }' -H "Content-Type: application/json"
   

   记得把your_secure_password换成你自己的密码。
3. 从2.x实例复制数据到3.x。这里需要用主机的IP（容器里访问localhost是容器自身，所以用主机真实IP，比如192.168.1.100）：

   curl -X POST http://localhost:5984/_replicate -d '{
     "source": "your_database_name",
     "target": "http://admin:your_secure_password@192.168.1.100:5984/your_database_name"
   }' -H "Content-Type: application/json"
   

   把your_database_name换成你实际的数据库名，192.168.1.100换成你的服务器IP。如果复制成功，会返回{"ok":true}的结果。
4. 重复上面的复制命令，把所有需要恢复的数据库都迁移过去。

第四步：清理收尾 #

1. 复制完成后，停止并删除临时的2.x容器：

   sudo docker stop couchdb2 && sudo docker rm couchdb2
   

2. 验证3.x里的数据：用curl访问数据库，或者直接测试你的Flask应用：

   curl http://admin:your_secure_password@localhost:5984/your_database_name
   

   正常情况下会返回数据库的基本信息，而不是not_found错误。

可能遇到的问题排查 #

• 如果2.x容器启动后看不到旧数据库：检查数据目录的权限是否正确，或者.couch文件是否损坏。
• 复制失败：检查3.x的管理员账号密码是否正确，主机IP是否能被容器访问，或者3.x是否开启了外部访问权限（默认是允许本地的，如果容器在同一主机，应该没问题）。

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