Stylus Studio X16切换至Saxon引擎执行XQuery时无限循环求助

我经手过不少Stylus Studio和Saxon的兼容性问题，结合你说多地同事都遇到相同情况，这绝对不是单一环境的异常，大概率是版本适配或配置层面的共性问题。下面是几个经过验证的排查和解决方向：

1. 检查Saxon版本兼容性 #

Stylus Studio X16默认集成的Saxon版本可能存在已知的循环bug，尤其是针对递归函数、嵌套FLWOR表达式这类语法结构。建议手动替换为稳定版本：

• 下载适配64位JVM环境的Saxon HE/PE/EE 9.9.x或10.x版本JAR包
• 打开Stylus Studio的「工具 > 选项 > XQuery > 处理器」
• 选中Saxon，点击「配置」，把默认的JAR路径替换成你下载的版本
• 重启Stylus Studio后测试查询

2. 排查XQuery语法的Saxon特异性问题 #

有些在DataDirect下正常的语法，到Saxon里可能触发非预期循环，比如：

• 没有终止条件的递归函数（缺少base case）
• 使用//轴的深层嵌套查询（Saxon的节点遍历逻辑和DataDirect不一样）
• 自定义函数里的逻辑死循环
  先拿极简测试XQuery（比如doc("test.xml")//title）验证是否还会循环，如果极简查询正常，再逐步添加原有代码片段定位问题点。

3. 调整Stylus Studio的Saxon运行参数 #

修改执行参数，强制限制递归深度或设置超时，避免完全卡死：

• 在Saxon配置界面添加JVM参数：-Dxsl:recursion-limit=1000（限制递归深度）
• 或者在「调试 > 调试选项」里设置「执行超时」，这样查询到时间会自动终止，还能拿到错误信息

4. 修复Stylus Studio安装文件 #

厂商说环境异常，但多地出现说明可能是build 'o'版本本身的bug：

• 完全卸载当前Stylus Studio，清理残留文件（包括C:\Program Files\Stylus Studio X16和用户目录下的配置文件夹）
• 下载官方最新的X16补丁包（如果有的话），选择自定义安装，确保Saxon组件完整安装
• 安装后先验证默认的DataDirect是否正常，再切换到Saxon测试

5. 开启Saxon调试日志 #

详细日志能帮你看到循环发生时的执行步骤：

• 在Saxon配置里添加JVM参数：-Dnet.sf.saxon.logLevel=TRACE
• 执行查询后，查看Stylus Studio「输出」面板里的日志，定位重复执行的代码段
  这些日志要么能帮你找到XQuery的逻辑漏洞，要么能给厂商提供精准的问题依据

如果以上方法都没用，建议收集以下信息提交给厂商：

• 能复现问题的极简XQuery代码
• Saxon完整日志文件
• 系统环境信息（Windows版本、JVM版本）
• 多地同事的环境共性（比如都是Windows 10/11 64位、相同JVM版本）

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