dnSpy反编译exe时async方法代码出现语法错误如何解决

问题成因 #

async/await是C#的编译期语法糖，编译阶段会被转换为包含状态机结构体、MoveNext执行方法、awaiter包装字段的IL代码，不会保留原生await语法结构。dnSpy反编译时需要逆向还原这一语法糖转换过程，当配置不匹配、版本对新框架适配不足时，就会出现标识符拼写错乱、语法结构残缺的问题，生成的代码无法直接识别、编译使用。

修复方案 #

• 调整dnSpy反编译配置
  打开顶部菜单栏路径 编辑 -> 选项 -> 反编译器 -> C# 配置页，按以下规则修改设置：
  • 勾选还原async/await语法糖选项，禁止反编译器直接输出原始状态机代码
  • 取消勾选自动优化生成的成员名称，避免工具错误替换编译器生成的状态机字段，造成标识符错拼、乱码
  • 将反编译使用的C#语言版本调整为与目标程序集编译版本一致，不要强制使用最高语言版本做兼容还原
• 升级/更换反编译工具
  dnSpy官方原版最后停更于2020年的6.1.8版本，对.NET 5及以上版本新增的异步代码模式还原存在大量已知bug，替换为社区维护迭代的dnSpyEx版本即可解决绝大多数异步反编译错误。若单工具还原结果存在错漏，可使用ILSpy、JetBrains dotPeek对同一方法做交叉反编译，对比输出结果修正错误点。
• 手动修正残留错漏
  配置调整后剩余的零星语法、拼写错误，基本都是状态机字段还原失败导致，无需对照IL修改，按以下通用规则调整即可：
  • 所有带<>、<>u__等非法前缀的乱码标识符，均为编译器自动生成的状态机局部变量、awaiter包装字段，按上下文语义重命名为符合C#命名规范的标识符即可，不会影响原有代码逻辑
  • 若await关键字位置报语法错误，检查是否遗漏对应Task的返回值类型声明，补全即可
  • 若异步方法返回值被错标为void，对照方法内部await的返回结果，修正为Task、Task<T>、ValueTask等正确的异步返回类型即可

反编译属于逆向还原过程，不存在100%完美还原的工具，经过混淆处理的程序集，异步方法还原后必然需要少量手动调整才能正常编译运行。

内容的提问来源于stack exchange，提问作者Özgür