MSBuild项目评估API中的路径解析回归问题分析

问题背景

在MSBuild 17.13版本中，开发人员发现了一个与项目评估API相关的严重回归问题。当使用Project类的构造函数通过XmlReader加载项目文件时，系统会抛出InternalErrorException异常，错误信息显示"MSB0001: Internal MSBuild Error: .SdkResolver.1981936763.proj unexpectedly not a rooted path"。

问题现象

这个问题的具体表现是：在17.12.6版本中能够正常工作的代码，在升级到17.13.9版本后会出现崩溃。问题的触发条件是在使用new Project(xmlReader,...)方式加载项目文件时，特别是当项目文件中包含Sdk引用（如<Project Sdk="Microsoft.NET.Sdk">）时。

技术分析

深入分析这个问题，我们发现根本原因在于MSBuild内部处理Sdk解析结果时的路径验证逻辑发生了变化。具体来说：

1. 在17.13版本中，Sdk解析结果(SdkResult)新增了两个属性：DOTNET_EXPERIMENTAL_HOST_PATH和SdkResolverMSBuildTaskHostRuntimeVersion。

2. 当MSBuild处理这些新增属性时，会尝试创建一个临时的项目文件（如.SdkResolver.1981936763.proj）来存储这些属性。

3. 问题出在这个临时文件的路径处理上 - 当通过XmlReader加载项目内容而没有提供明确的项目文件路径时，MSBuild无法为这个临时文件生成一个根路径(rooted path)，导致内部验证失败。

影响范围

这个回归问题主要影响以下使用场景：

• 通过内存中的XML内容（而非磁盘文件）加载MSBuild项目的应用程序
• 使用MSBuild评估API进行动态项目处理的工具
• 不依赖物理文件路径的项目加载场景

解决方案与建议

目前微软团队已经意识到这个问题，并正在考虑以下几种解决方案：

1. 短期解决方案：在验证逻辑中添加对非根路径的容错处理，避免直接抛出异常。

2. 长期解决方案：完善临时文件的路径生成机制，确保即使在没有明确项目路径的情况下也能生成有效的根路径。

对于受影响的开发人员，目前可以采取以下临时解决方案：

• 尽量使用基于文件路径的Project构造函数，而非基于XmlReader的版本
• 如果需要使用XmlReader，可以先创建一个具有明确路径的ProjectRootElement

经验教训

这个案例提醒我们：

1. API行为的改变可能会在看似不相关的场景中引发问题
2. 路径处理是构建系统中需要特别关注的敏感区域
3. 全面的测试覆盖对于防止回归问题至关重要

微软团队已经将增加相关测试用例纳入后续工作计划，以防止类似问题再次发生。