WSO2 APIM 4.2.0内存持续增长问题排查与解决咨询

原因分析 #

• JVM参数配置不当：WSO2 APIM默认启动脚本的堆内存设置未适配16GB内存服务器，或垃圾回收策略配置不合理，导致对象无法及时回收，内存逐步累积。
• 内置组件内存泄漏：部分内置定时任务、缓存组件（如注册表缓存、网关路由缓存）未正确处理对象生命周期，长期运行后产生内存泄漏；部分第三方依赖库存在潜在泄漏问题。
• 日志/监控数据未及时清理：默认配置下日志未开启自动滚动，或监控指标（如Metrics）持续在内存中累积未持久化，占用大量内存。
• 系统级内存机制影响：Oracle Linux 8默认启用的透明大页（THP）干扰JVM内存管理，降低GC效率，加剧内存占用异常。

解决方案 #

1. 优化JVM参数配置 #

编辑<APIM_HOME>/bin/wso2server.sh，调整堆内存与GC参数适配16GB服务器：

# 堆内存设置为服务器内存的50%-70%（16GB内存建议8G-10G）
-Xms8G -Xmx10G
# 启用G1垃圾回收器提升回收效率
-XX:+UseG1GC
-XX:MaxGCPauseMillis=200
-XX:+ParallelRefProcEnabled
# 开启OOM时堆转储，用于后续排查
-XX:+HeapDumpOnOutOfMemoryError
-XX:HeapDumpPath=<APIM_HOME>/repository/logs/heapdump.hprof

2. 清理与优化内置组件配置 #

• 调整缓存参数：编辑<APIM_HOME>/repository/conf/deployment.toml，开启缓存过期机制并限制缓存大小：

  # 注册表缓存配置
  [registry.cache]
  enabled = true
  timeout = 1800 # 缓存过期时间（秒）
  max_cache_capacity = 1000 # 最大缓存条目数
  
  # 网关缓存配置
  [apim.gateway.cache]
  enabled = true
  timeout = 300
  

• 禁用不必要的定时任务：检查<APIM_HOME>/repository/conf/tasks.xml，关闭不需要的内置统计类定时任务，减少对象累积。

3. 配置日志自动滚动 #

编辑<APIM_HOME>/repository/conf/log4j2.properties，开启日志滚动避免内存占用：

appender.CARBON_LOGFILE.type = RollingFile
appender.CARBON_LOGFILE.filePattern = ${sys:carbon.home}/repository/logs/wso2carbon-%d{MM-dd-yyyy}-%i.log.gz
appender.CARBON_LOGFILE.policies.type = Policies
appender.CARBON_LOGFILE.policies.size.type = SizeBasedTriggeringPolicy
appender.CARBON_LOGFILE.policies.size.size = 100MB
appender.CARBON_LOGFILE.strategy.type = DefaultRolloverStrategy
appender.CARBON_LOGFILE.strategy.max = 20

4. 禁用Oracle Linux 8透明大页（THP） #

# 临时禁用
echo never > /sys/kernel/mm/transparent_hugepage/enabled
echo never > /sys/kernel/mm/transparent_hugepage/defrag

# 永久禁用：编辑/etc/default/grub，将以下参数加入GRUB_CMDLINE_LINUX
GRUB_CMDLINE_LINUX="... transparent_hugepage=never"
# 更新grub配置并重启
grub2-mkconfig -o /boot/grub2/grub.cfg
reboot

5. 内存泄漏深度排查（若上述方法无效） #

• 生成堆转储文件：

  jmap -dump:format=b,file=heapdump.hprof <APIM进程PID>
  

• 使用jvisualvm或Memory Analyzer Tool（MAT）打开堆转储文件，定位占用内存的对象，排查具体泄漏点。

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