使用saxonche+FastAPI处理XML，ARM64生产环境多文件处理遇栈溢出求助

场景与错误信息 #

我使用Python的saxonche库执行XPath3.1操作，搭建了FastAPI服务，接收XML文件名后打开文件处理并返回响应。该服务在Intel MacBook开发环境运行正常，但在AWS m7g.2xlarge实例（Debian 12 ARM64）生产环境处理多文件时，出现如下致命错误：

Fatal error: StackOverflowError: Enabling the yellow zone of the stack did not make any stack space available. Possible reasons for that: 1) A call from native code to Java code provided the wrong JNI environment or the wrong IsolateThread; 2) Frames of native code filled the stack, and now there is not even enough stack space left to throw a regular StackOverflowError; 3) An internal VM error occurred.

XML文件大小为5-8MB。

问题解答 #

1. saxonche是否存在同时处理多文件的限制？ #

Saxonche本身没有明确的同时处理多文件的硬性限制，但它底层依赖Java虚拟机（通过JNI调用Java实现XPath逻辑），JVM的栈内存配置、线程模型会直接影响并发处理能力。多文件并发时，若每个请求对应的线程栈内存不足，或线程数量过多导致栈内存总占用超标，就会触发StackOverflowError。另外，ARM64架构下的JNI调用栈内存分配逻辑可能与x86存在差异，这也是开发环境正常、生产环境出问题的潜在原因。

2. 升级服务器Java版本能否解决该问题？ #

有可能，但并非绝对。如果当前Java版本存在ARM64架构下JNI栈内存管理的已知bug，升级到修复该问题的版本可以解决。但如果问题根源是栈内存配置不足、并发线程数过高，单纯升级Java版本无法解决，需要调整JVM参数或服务并发模型。

故障排查与解决建议 #

• 调整JVM栈内存参数：通过SAXON_JAVA_OPTS环境变量为saxonche的JVM实例传递参数，增大线程栈大小（例如设置-Xss2m，默认通常为1m），同时调整堆内存参数（-Xmx）确保整体内存充足。
• 限制服务并发数：结合AWS实例的CPU和内存配置，调整Uvicorn的--workers和--threads参数，降低同时处理的请求数，避免栈内存被大量线程耗尽。
• 验证ARM64兼容性：确认所用saxonche版本完全支持ARM64架构，旧版本可能存在非x86架构下的JNI栈处理问题，尝试升级到最新稳定版。
• 单文件测试排查：在生产环境重复测试单文件处理，确认是单文件处理就存在栈溢出，还是仅多文件并发时触发。若单文件也出问题，需检查XPath表达式是否存在递归过深、层级遍历过多的情况，优化XPath逻辑。
• 监控栈内存状态：使用jstack或jconsole等工具监控JVM线程栈使用情况，确认是否为栈内存不足导致的问题。

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