CouchDB内存清理：解决大二进制文件泄漏致内存居高不下问题

一、调整CouchDB核心配置触发自动回收 #

直接修改CouchDB配置文件，让系统自动管理内存与索引清理：

1. 进入Pod编辑配置文件：

   kubectl exec -it <你的CouchDB Pod名称> -- vi /opt/couchdb/etc/local.ini
   

2. 添加或更新以下配置项：

   [query_server_config]
   # 限制查询进程数量，减少闲置进程内存占用
   os_process_limit = 6
   # 单个查询进程内存上限，根据Pod内存调整，示例为256M
   max_os_process_memory = 268435456
   [view_index]
   # 缩短索引自动清理间隔为5分钟
   cleanup_interval = 300
   # 设置视图索引工作进程内存上限，示例为128M
   view_index_worker_memory_limit = 134217728
   

3. 重启StatefulSet让配置生效：

   kubectl rollout restart statefulset <你的CouchDB StatefulSet名称>
   

二、正确连接Erlang节点触发全量垃圾回收 #

之前的remsh连接失败是因为节点名称与启动方式错误，按以下步骤操作：

1. 进入Pod后，获取CouchDB的Erlang节点名称：

   ps aux | grep beam.smp | awk '{print $NF}'
   

   输出一般为couchdb@127.0.0.1或对应Pod的IP节点名
2. 使用CouchDB自带工具连接remsh（Bitnami默认cookie为monster）：

   /opt/couchdb/bin/couchdb-cli remsh -n <获取到的节点名> -c monster
   

3. 连接成功后执行全量GC命令：

   % 强制开启全量扫描模式
   erlang:system_flag(fullsweep_after, 0),
   % 给所有进程触发垃圾回收
   lists:foreach(fun(P) -> erlang:garbage_collect(P) end, processes()),
   % 恢复默认值，避免频繁全量GC影响性能
   erlang:system_flag(fullsweep_after, 65535).
   

   执行完成后退出shell，观察内存变化。

三、Kubernetes层面配置内存管控 #

给Pod设置合理的内存限制，同时配置OOM策略让系统在内存过载时主动回收：
在Helm的values.yaml中更新配置：

clusterSize: 1
couchdbConfig:
  cluster:
    n: 1
  couchdb:
    single_node: true
# 添加资源限制与系统参数配置
resources:
  requests:
    memory: "2Gi"
    cpu: "1"
  limits:
    memory: "4Gi"
podSecurityContext:
  sysctls:
    - name: vm.overcommit_memory
      value: "1"

然后更新Helm Release：

helm upgrade <你的Helm Release名称> bitnami/couchdb -f values.yaml

四、优化视图索引构建方式 #

• 拆分复杂视图为多个小视图，分批构建，避免一次性占用大量内存
• 删除无用的设计文档与索引，调用API：curl -X DELETE http://<couchdb地址>/<数据库名>/_design/<设计文档名> -u admin:<密码>
• 针对大数据量视图，选择非业务高峰时段执行索引构建，或使用增量构建方式

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