开发者中心

# 数据源调试

数据源调试用于排查ESB数据源运行过程中的问题，通过查看运行日志定位数据源配置或执行异常。

# 1. 数据源调试基本流程

# 1.1 调试路径

  • 位置：流程库 → ESB运行实例 → 数据源调试
  • 功能：查看数据源运行日志和异常信息

# 1.2 调试步骤

  1. 打开数据源调试页面
  2. 选择需要调试的数据源实例
  3. 进入运行追踪界面
  4. 检查每个节点的：
    • 输入数据（Input）
    • 输出数据（Output）
    • 执行状态（Status）
    • 错误信息（Error Message）

调试界面 ▲ 调试界面

# 2. 与ESB输出流调试的区别

特性 数据源调试 ESB输出流调试
主要目的 问题定位 问题定位与修复
日志记录 需手动开启 默认记录
实例修复 不支持 支持
典型应用场景 开发阶段问题排查 生产环境异常处理

# 3. 日志记录配置

# 3.1 配置文件修改

  1. 打开appsettings.json文件
  2. 定位到ESB配置节：
"ESB": {
  "PersistenceDataSourceInstance": false
}
  1. 修改为：
"ESB": {
  "PersistenceDataSourceInstance": true
}

# 3.2 配置注意事项

  1. 开发环境：可长期开启以便调试
  2. 生产环境：
    • 仅在需要调试时临时开启
    • 调试完成后应立即关闭

# 4. 调试技巧

  1. 逐步检查法：按执行顺序逐个节点检查
  2. 数据对比法：对比预期与实际输入/输出数据
  3. 边界值测试：测试各种边界条件下的数据源行为
  4. 日志分析：结合系统日志分析执行上下文

# 5. 常见问题排查

# 5.1 数据源无日志

  • 检查PersistenceDataSourceInstance是否已设为true
  • 确认配置文件已生效（重启服务）

# 5.2 数据转换异常

  • 检查源数据和目标数据结构是否匹配
  • 验证数据类型转换规则

# 5.3 连接失败

  • 检查连接字符串配置
  • 验证网络连通性
  • 确认数据库权限设置

# 6. 总结

数据源调试的关键要点：

  1. 访问路径：通过ESB运行实例的数据源调试页面
  2. 必备设置：调试前开启PersistenceDataSourceInstance配置
  3. 调试重点：分析节点输入数据和错误信息
  4. 环境管理：生产环境调试后及时关闭日志记录

通过数据源调试功能，可以快速定位和解决数据源配置和执行过程中的问题，提高ESB开发的效率和质量。

← 通用数据源 →