jemalloc环境变量介绍_jemalloc 选项设置-CSDN博客

jemalloc 环境变量详解与设置方法

jemalloc 是一款高性能、可扩展的通用内存分配器，广泛应用于 Redis、MySQL、ClickHouse、Facebook 等高并发场景。合理配置 jemalloc 的环境变量，可以更好地控制内存分配和调优程序性能。本文将详细介绍 jemalloc 常见环境变量的含义及其设置方式。

jemalloc 支持通过环境变量调整其运行时行为，涵盖内存分配策略、统计分析、调试、日志输出等多个方面。大多数变量无需重启程序即可生效，适合灵活调优和排查问题。

环境变量	作用简介	典型用法例子
`MALLOC_CONF`	jemalloc 的主配置入口，支持逗号分隔的多项参数，控制分配策略、日志、统计等。	`MALLOC_CONF=option1:value1,option2:value2`
`MALLOC_STATS_PRINT`	设置为非空值时，程序退出时自动打印 jemalloc 内存统计信息。	`export MALLOC_STATS_PRINT=1`
`JEMALLOC_STATS`	控制是否采集和导出统计信息。	`export JEMALLOC_STATS=1`
`JEMALLOC_PROF`	启用 heap profile 采样（内存分配火焰图/分析）。	`export JEMALLOC_PROF=true`
`JEMALLOC_PROF_PREFIX`	指定 profile 输出文件前缀。	`export JEMALLOC_PROF_PREFIX=heap_profile`
`JEMALLOC_PROF_ACTIVE`	动态启用/禁用 heap profiling。	`export JEMALLOC_PROF_ACTIVE=false`
`JEMALLOC_PAGESIZE`	指定 jemalloc 的最小分配粒度（页大小）。	`export JEMALLOC_PAGESIZE=4096`
`JEMALLOC_TCACHE`	启用/禁用线程本地缓存（tcache），加速小对象分配。	`export JEMALLOC_TCACHE=false`
`JEMALLOC_MMAP_THRESHOLD`	大于此阈值的分配将直接使用 mmap。	`export JEMALLOC_MMAP_THRESHOLD=131072`
`JEMALLOC_ARENA_MAX`	设置最大 arena 数量，影响多线程扩展能力和碎片率。	`export JEMALLOC_ARENA_MAX=8`

注：很多配置建议通过 MALLOC_CONF 统一设置，某些变量仅特定版本有效，详细可查阅对应版本官方文档。

MALLOC_CONF 是 jemalloc 的核心配置入口，通过逗号分隔的方式设置多个参数。常见参数如下：

参数	作用说明	示例值
`narenas`	arena 区域个数，决定多线程并发能力（一般设置为 CPU 核数2倍以内）。	`narenas:8`
`tcache`	是否启用线程本地缓存（true/false）。	`tcache:false`
`lg_chunk`	chunk 大小的对数（如 21=2MB, 22=4MB）。	`lg_chunk:21`
`stats_print`	程序退出时打印统计信息，或收到信号时。	`stats_print:true`
`background_thread`	是否启用后台线程进行内存回收。	`background_thread:true`
`dirty_decay_ms`	脏页回收等待时间（毫秒）。	`dirty_decay_ms:1000`
`muzzy_decay_ms`	muzzy页回收等待时间（毫秒）。	`muzzy_decay_ms:5000`

export MALLOC_CONF="narenas:8,tcache:true,stats_print:true,background_thread:true"
./your_program

部分 jemalloc 版本支持在运行时通过 mallctl 接口查询/修改参数，可以用如 je_malloc_conf 环境变量或 API 方式动态调整。

export MALLOC_CONF="tcache:false,stats_print:true"
export MALLOC_STATS_PRINT=1
./your_program

可将导出语句加入 .bashrc、.profile 或服务启动脚本：

export MALLOC_CONF="narenas:8,background_thread:true,stats_print:true"

MALLOC_CONF="tcache:false,stats_print:true" ./your_program

如何减少内存碎片？
增加 arena 数量、开启后台回收线程、调整 decay 参数、优化分配模式。
如何采集 heap profile？
开启 JEMALLOC_PROF=true 并设置 JEMALLOC_PROF_PREFIX，用 jeprof 工具分析。
如何禁用线程缓存？
MALLOC_CONF="tcache:false" 或 export JEMALLOC_TCACHE=false
参数无效怎么办？
检查 jemalloc 版本、拼写、程序是否实际使用了 jemalloc（ldd 检查）。