Azure ADL U-SQL提取JSON报错：调用MultiLevelJsonExtractor的Extract方法异常

我之前也踩过类似的坑，先帮你理清楚问题和可行的解决方向：

首先，你遇到的错误是：

ADL报告调用用户类型'Microsoft.Analytics.Samples.Formats.Json.MultiLevelJsonExtractor'的'Extract'方法时出现未处理的用户代码异常。

而且你已经安装了对应程序集，但处理JSON作业还是报错，你的代码片段是：

REFERENCE ASSEMBLY BankingADLDB.[Newtonsoft.Json];
REFERENCE ASSEMBLY BankingADLDB.[Microsoft.Analytics.Samples.Formats];
USING Microsoft.Analytics.Sam...

几个实用的排查和解决办法 #

• 先盯紧版本兼容性：这是最常见的原因！Microsoft.Analytics.Samples.Formats对Newtonsoft.Json的版本有严格依赖，比如早期的Samples.Formats只支持Newtonsoft.Json v10.x，如果你装了v13.x这类高版本，肯定会出问题。建议去查一下你用的Samples.Formats版本对应的官方推荐Newtonsoft.Json版本，然后替换成匹配的版本再试。
• 补全你的USING语句：看你的代码里USING Microsoft.Analytics.Sam...明显没写完，必须完整引用到JSON提取器的命名空间：USING Microsoft.Analytics.Samples.Formats.Json;，不然ADL找不到MultiLevelJsonExtractor的定义，运行时自然会炸。
• 检查JSON文件本身：别光怪组件，有时候是你的JSON文件有格式问题——比如少了个闭合括号、特殊字符没转义、数组结构不合法之类的。先拿个极简的测试JSON（比如只有一层简单结构的）跑一遍，如果能正常提取，那就是原JSON文件的问题，找个JSON校验工具排查下。
• 确认程序集部署到位：你说安装了对应程序集，但要确认它们真的在ADL的目标数据库（BankingADLDB）里。可以跑个查询看看：

  SELECT name, assembly_id, file_name FROM sys.assembly_files WHERE assembly_id IN (SELECT assembly_id FROM sys.assemblies WHERE name IN ('Newtonsoft.Json', 'Microsoft.Analytics.Samples.Formats'));
  

  如果查不到对应的记录，说明程序集没部署对，得重新上传部署。
• 加个异常捕获看细节：泛泛的“未处理异常”没什么用，你可以在代码里加个try-catch，把具体的错误信息打出来，比如：

  try
  {
      var extractor = new MultiLevelJsonExtractor("yourJsonPath");
      // 后续提取逻辑
  }
  catch (Exception ex)
  {
      Output.WriteLine($"具体错误：{ex.Message}\n调用栈：{ex.StackTrace}");
  }
  

  这样能拿到更精准的错误原因，比如是找不到字段、内存溢出还是其他问题。

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