Docker部署Corda节点遭遇Java堆内存不足问题求助

从你给出的错误日志和docker-compose配置来看，问题很明确：除公证人外的节点因为加载了体积较大的CorDapp，导致JVM堆内存耗尽——公证人没问题正是因为它没有挂载./build/libs/这个CorDapp目录，无需加载这些大文件。

下面是几个直接有效的解决方案，按优先级排序：

1. 直接调整JVM堆内存参数 #

Corda节点启动时会读取JAVA_OPTS环境变量来配置JVM参数，你可以在docker-compose的每个业务节点（partya、partyb、oracle）中添加这个环境变量，设置足够的堆内存：

partyb:
  # 原有配置不变
  environment:
    - JAVA_OPTS="-Xms2g -Xmx4g"  # 初始堆2G，最大堆4G，根据你的CorDapp大小调整

如果你的Docker版本支持CGroup内存限制，可以加上-XX:+UseCGroupMemoryLimitForHeap参数，让JVM自动适配容器的内存限制：

environment:
  - JAVA_OPTS="-Xms2g -Xmx4g -XX:+UseCGroupMemoryLimitForHeap"

2. 给Docker容器设置内存限制（配合JVM参数） #

在docker-compose中给每个业务节点添加内存资源限制，避免容器占用过多宿主机资源，同时和JVM参数配合使用：

partyb:
  # 原有配置不变
  deploy:
    resources:
      limits:
        memory: 5g  # 容器最大可用内存，要比Xmx大（留足JVM非堆内存空间）
      reservations:
        memory: 2g  # 容器预留内存

3. 优化CorDapp体积（长期解决方案） #

如果堆内存调大只是临时解决，建议优化CorDapp的大小：

• 检查build/libs/目录，清理冗余的Jar包，比如移除测试依赖、重复的第三方库
• 使用ShadowJar打包时，通过exclude配置排除不必要的依赖模块
• 将多个CorDapp共享的依赖提取到单独的目录，避免重复加载

4. 检查Corda节点配置文件 #

确认你的node.conf中没有覆盖JVM堆参数的配置，比如是否存在jvmArgs字段，如果有，需要确保它和docker-compose的JAVA_OPTS保持一致，或者直接移除该字段让环境变量生效。

修改后的完整业务节点示例 #

以partyb为例，修改后的配置如下：

partyb:
  image: corda/corda-zulu-4.0:latest
  container_name: partyb
  networks:
    - corda
  environment:
    - JAVA_OPTS="-Xms2g -Xmx4g -XX:+UseCGroupMemoryLimitForHeap"
  deploy:
    resources:
      limits:
        memory: 5g
      reservations:
        memory: 2g
  volumes:
    - ./nodes/partyb_node.conf:/etc/corda/node.conf
    - ./nodes/partyb/certificates:/opt/corda/certificates
    - ./nodes/partyb/network-parameters:/opt/corda/network-parameters
    - ./build/libs/:/opt/corda/cordapps
    - ./nodes/partyb/additional-node-infos:/opt/corda/additional-node-infos

把同样的配置应用到partya和oracle节点，应该就能解决堆内存不足的问题了。如果还是报错，可以适当增大Xmx的值（比如调到6G），同时对应提高容器的内存限制。

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