Neo4j 4.3.3 apoc.periodic.iterate仅用单核：concurrency参数工作原理是什么？

基础结论 #

你的预期完全正确，apoc.periodic.iterate的concurrency功能符合设计预期，可实现真正并行，你遇到的耗时异常不属于Neo4j/APOC的bug，是Docker/K8s环境下JVM核心识别异常导致的。

你配置的参数完全符合官方设计逻辑：

• parallel: true 开启批次多线程执行
• batchSize: 1 拆分出10个独立执行批次
• concurrency: 10 允许同时运行10个并发任务
  正常物理机环境下这套代码的执行时间确实应该在1秒左右，你的调试日志也显示10个批次都被正确提交，只是实际运行时被JVM的核心识别限制成了串行执行。

问题根因 #

低版本JDK（JDK10之前的版本，以及部分JDK11早期小版本）默认不会识别Cgroup限制的CPU资源，当K8s没有显式配置CPU limits/requests，或者JVM未开启Cgroup资源识别参数时，Runtime.getRuntime().availableProcessors() 会默认返回1，APOC的线程池会基于这个值做并发上限限制，导致你设置的concurrency: 10实际无法生效。

无需硬编码的解决方案 #

有三种通用方案可以避免硬编码CPU核心数：

• 升级JDK版本到JDK11 0.16+ 或者JDK17及以上版本，这些版本默认开启Cgroup资源识别，会自动读取K8s分配给Pod的CPU核心数，不需要额外配置参数。
• 如果你使用的是Neo4j官方Docker镜像，升级到4.4及以上版本即可，这类版本已经默认开启了JVM的Cgroup支持，不需要额外传入-XX:ActiveProcessorCount参数。
• 如果必须使用当前的Neo4j和JDK版本，可以配合K8s的Downward API将分配给Pod的CPU核心数作为环境变量传入，再动态赋值给-XX:ActiveProcessorCount，不需要手动写死固定数值。

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