# 数据源调试

# 调试准备

# 1. 启用日志记录

  • 修改appsettings.json配置文件:
{
  "ESB": {
    "PersistenceDataSourceInstance": true
  }
}
  • 作用:开启后所有数据源运行将记录完整日志

# 2. 触发调试数据

  • 操作路径:流程库 → ESB数据源 → 选择目标数据源 → 点击"测试"

# 日志查看方法

# 访问路径

流程库 → ESB运行实例 → 数据源调试页签

# 日志界面功能

区域 功能说明
实例列表 按时间倒序显示所有运行记录
图形化追踪 显示数据流经的节点链路
节点详情面板 展示输入/输出/错误信息

# 节点追踪技巧

# 1. 标准检查流程

  • 选择问题实例
  • 逐个检查节点
  • 数据是正确
    • 是,检查下一节点
    • 否,定位问题点

# 2. 关键检查项

  • 输入数据
    • 是否符合节点预期格式
    • 是否包含必要字段
  • 输出数据
    • 是否完成预期转换
    • 空值处理是否合理
  • 执行信息
    • 耗时是否异常
    • 错误堆栈信息(如有)

# 常见问题排查

# 典型问题场景

  1. 数据中断

    • 现象:某个节点无输出
    • 检查:
      • 上游节点输出是否正常
      • 映射规则是否正确
  2. 数据异常

    • 现象:输出值不符合预期
    • 检查:
      • JS映射代码逻辑
      • 数据类型转换
  3. 执行失败

    • 现象:节点显示错误标志
    • 检查:
      • 错误信息页签
      • 连接配置(如数据库连接字符串)

# 注意事项

  1. 生产环境建议关闭持久化日志(PersistenceDataSourceInstance:false
  2. 敏感数据会自动脱敏显示