SHACL-JS调用JS函数调试求助：日志无输出

问题背景 #

使用SHACL-JS结合SHACL-X执行RDF数据验证，验证逻辑依赖JS函数完成数学计算。该JS函数单独测试运行正常，但通过SHACL形状调用时会报错，且无法定位具体原因。为排查参数传递问题，在JS函数中添加了console.log语句，但调用时无任何日志输出，服务器日志仅记录Nginx启动和JS文件请求记录，无函数执行相关日志。

排查思路 #

• 确认JS执行上下文差异：SHACL-JS的运行环境可能不是标准浏览器/Node.js环境，比如部分SHACL引擎（如Apache Jena、TopBraid）使用Java内嵌的JS引擎（GraalVM/Nashorn），这类环境下console.log不会直接输出到服务器日志。
• 检查函数是否正常启动：若参数获取逻辑（如$centerofrotationBoom.getLex()）报错，函数可能在执行到console.log前就终止。可在函数最开头添加极简日志（如console.log("Function started")），验证函数是否被触发执行。
• 核对SHACL形状的调用配置：确认SHACL形状中sh:jsFunction指向的JS文件路径正确，sh:parameter的变量名与JS中的$xxx完全匹配，无拼写错误。

解决方案 #

1. 适配SHACL引擎的日志输出方式 #

根据不同的SHACL运行环境调整日志输出代码：

• Java内嵌JS引擎环境：替换console.log为Java系统输出或日志框架API：

  // 直接输出到Java标准输出
  Java.type('java.lang.System').out.println("Surface data: " + surfaceInConcatSurface);
  // 或使用SLF4J日志框架（若引擎集成）
  var LoggerFactory = Java.type('org.slf4j.LoggerFactory');
  var logger = LoggerFactory.getLogger('SHACLValidation');
  logger.info(JSON.stringify(polyhedralSurfaces));
  

• Node.js环境：若使用Node.js版SHACL引擎，可改用process.stdout.write()避免缓冲问题，或确保引擎配置了日志输出重定向。

2. 添加异常捕获，定位终止原因 #

在函数外层包裹异常捕获块，强制输出错误信息：

try {
    Java.type('java.lang.System').out.println("Function execution started");
    var centerofrotationBoom = convertPointStringToArray($centerofrotationBoom.getLex());
    var surfaceInConcatSurface = $concatSurfaces.getLex().split(" // ");
    Java.type('java.lang.System').out.println(surfaceInConcatSurface);
    // ... 剩余计算逻辑 ...
} catch (e) {
    Java.type('java.lang.System').out.println("Error in SHACL JS function: " + e.message);
    Java.type('java.lang.System').out.println("Stack trace: " + e.stackTrace);
}

3. 验证SHACL形状的参数绑定 #

确保SHACL形状中的参数定义与JS变量完全匹配，示例如下：

:RotationalConstraintShape a sh:NodeShape ;
    sh:targetClass :RotationalComponent ;
    sh:jsFunction [
        sh:name "rotationalConstraintValidation" ;
        sh:parameter [
            sh:path :centerofrotationBoom ;
            sh:varName "$centerofrotationBoom" ;
        ] ;
        sh:parameter [
            sh:path :concatSurfaces ;
            sh:varName "$concatSurfaces" ;
        ] ;
        sh:script <file:./RotationalConstraintChecking.js> ;
    ] .

4. 通过SHACL验证报告返回调试信息 #

若日志输出仍有困难，可让JS函数返回包含调试信息的验证结果，直接在SHACL报告中查看：

function rotationalConstraintValidation() {
    try {
        var surfaceInConcatSurface = $concatSurfaces.getLex().split(" // ");
        // ... 计算逻辑 ...
        // 验证失败时返回带调试信息的结果
        return {
            conforms: false,
            message: "Validation failed. Surfaces data: " + JSON.stringify(surfaceInConcatSurface)
        };
    } catch (e) {
        return {
            conforms: false,
            message: "Function error: " + e.message + ", stack: " + e.stack
        };
    }
}

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