内存锁定配置

配置项作用 #

bootstrap.memory_lock 配置项控制是否锁定 JVM 内存，防止其被操作系统交换到磁盘（swap）。启用此配置可以提高 Easysearch 的性能和稳定性。

配置项类型 #

该配置项为静态配置，需要在启动时设置，修改后需要重启节点才能生效。

默认值 #

false（不启用）

是否必需 #

可选配置项

工作原理 #

未启用内存锁定（默认）：

JVM 堆内存
    │
    ▼
内存压力时
    │
    ▼
部分内存被交换到磁盘 (swap)
    │
    ▼
性能下降、延迟增加

启用内存锁定：

JVM 堆内存
    │
    ▼
被 mlockall() 锁定在物理内存
    │
    ▼
不会被交换到磁盘
    │
    ▼
稳定性能、低延迟

平台实现差异 #

使用示例 #

# 启用内存锁定（推荐生产环境）
bootstrap.memory_lock: true

# 不启用（默认）
bootstrap.memory_lock: false

推荐设置建议 #

生产环境强烈建议设置为 true

理由：

1. 性能稳定：避免因内存交换导致的性能波动
2. 延迟可控：确保响应时间不会因 swap 而激增
3. 防止 OOM：减少因交换导致的内存不足风险
4. 最佳实践：是 Elasticsearch/Easysearch 官方推荐的生产配置

系统配置要求 #

Linux 系统：

启用内存锁定需要配置系统限制：

# 编辑 /etc/security/limits.conf
easysearch soft memlock unlimited
easysearch hard memlock unlimited

# 或使用 systemd 服务配置
[Service]
LimitMEMLOCK=infinity

Windows 系统：

需要以管理员权限运行，或授予 “锁定内存页” 权限。

验证内存锁定状态 #

可以通过 API 验证内存锁定是否生效：

GET /_nodes/stats/process?filter_path=**.mlockall

# 响应示例
{
  "nodes": {
    "node_id": {
      "process": {
        "mlockall": true
      }
    }
  }
}

常见问题 #

问题 1：内存锁定失败

Unable to lock JVM Memory

解决方案：

1. 检查系统限制配置
2. 确保 Easysearch 运行用户有足够权限
3. 验证 LimitMEMLOCK=infinity 配置

问题 2：启动失败

mlockall failed for resource

解决方案：

1. 检查可用物理内存是否足够
2. 确保 JVM 堆大小不超过可用物理内存
3. 考虑减少堆大小或增加物理内存

资源规划 #

启用内存锁定时，需要确保：

JVM 堆内存 + JVM 元空间 + 操作系统预留 <= 可用物理内存

示例配置：

性能影响 #

相关配置项 #

注意事项 #

1. 静态配置：修改此配置需要重启节点
2. 权限要求：需要相应的系统权限才能锁定内存
3. 内存充足：确保物理内存足够容纳 JVM 堆
4. 监控建议：监控内存使用情况，避免 OOM
5. 生产必需：生产环境强烈建议启用此配置