MSTest 3.x 升级到 4.x 时如何修复编译错误…

在把 MSTest 3.x 测试项目升级到 4.x（含 MSTest.Sdk、MSTest.TestFramework/TestAdapter）时，按步骤完成包升级、源码破坏性变更修复、运行时行为适配与验证。

适用场景

解决思路

1. 先检查项目：在 .csproj、Directory.Build.props 或 Directory.Packages.props 中查找 MSTest、MSTest.TestFramework、MSTest.TestAdapter、MSTest.Sdk 的包引用，确认当前是 3.x（若是 v1/v2 先用 migrate-mstest-v1v2-to-v3）；检查目标框架、自定义 TestMethodAttribute 子类、ExpectedExceptionAttribute 用法、Assert.ThrowsException 用法；先跑一次干净构建建立基线。
2. 解析目标版本：从项目配置的包源查询当前最新的稳定 v4 版本，不要照抄示例版本；把 metapackage、单独包、MSTest.Sdk、中央包管理中的版本统一固定为同一版本。
3. 更新包：MSTest metapackage 更新 PackageReference；单独包更新 MSTest.TestFramework 与 MSTest.TestAdapter；MSTest.Sdk 更新项目或 global.json 中的 SDK 版本；然后运行 dotnet restore 和 dotnet build，收集所有错误。
4. 修复源码破坏性变更（先全项目扫描所有模式再动手）：自定义 TestMethodAttribute 的 Execute 改为 ExecuteAsync 返回 Task<TestResult[]>（纯同步逻辑用 Task.FromResult，需要调用 base 或其他异步方法时用 async/await）。
5. TestMethodAttribute 构造函数新增 CallerInfo：子类构造函数加 [CallerFilePath] string callerFilePath = "" 和 [CallerLineNumber] int callerLineNumber = -1 并传给 base(callerFilePath, callerLineNumber)；若子类自带 displayName 参数，只把 caller info 传给 base，把 displayName 赋给 DisplayName 属性。
6. 把 [TestMethodAttribute("Custom display name")] 改为 [TestMethodAttribute(DisplayName = "Custom display name")]。
7. 移除 ClassCleanupBehavior 枚举参数：把 [ClassCleanup(ClassCleanupBehavior.EndOfClass)] 改为 [ClassCleanup]；原先用 EndOfAssembly 的清理逻辑改放到 [AssemblyCleanup] 方法。
8. TestContext.Properties 现在是 IDictionary<string, object>：把 Properties.Contains("key") 改为 Properties.ContainsKey("key")。
9. TestTimeout 枚举已移除：把 [Timeout(TestTimeout.Infinite)] 改为 [Timeout(int.MaxValue)]。
10. TestContext.ManagedType 已移除：改用 TestContext.FullyQualifiedTestClassName。
11. Assert 消息重载变更：把 Assert.AreEqual(a, b, "msg {0}", arg) 这类 message+params 重载改为字符串插值 $"msg {arg}"。
12. Assert.ThrowsException 已重命名：改为 Assert.ThrowsExactly<T>（严格类型匹配，等价旧行为）或 Assert.Throws<T>（允许派生类型）。
13. Assert.IsInstanceOfType 的 out 参数已移除：把 Assert.IsInstanceOfType<T>(obj, out var t) 改为 var t = Assert.IsInstanceOfType<T>(obj)，保留具体断言类型与后续变量用法。
14. Assert.AreEqual 针对 IEquatable<T> 的重载已移除：若出现泛型类型推断错误，显式指定类型参数为 object。
15. ExpectedExceptionAttribute 已移除：把 [ExpectedException(typeof(T))] 改为在测试体内用 Assert.ThrowsExactly<T>(() => ...)；只把预期抛异常的调用包进 lambda，Arrange/Setup 语句留在外面；异步测试用 await Assert.ThrowsExactlyAsync<T>(...)。
16. 若 [ExpectedException] 用了 AllowDerivedTypes 属性，改用 Assert.ThrowsAsync<T>（基类型匹配）而不是 Assert.ThrowsExactlyAsync<T>。
17. 目标框架被裁剪：MSTest v4 支持 net8.0、net9.0、net462+、uap10.0.16299、net9.0-windows10.0.17763.0、net8.0-windows10.0.18362.0；把 net5.0/net6.0/net7.0 等改为 net8.0 或 net9.0。
18. UnfoldingStrategy 属性从 DataRowAttribute、DynamicDataAttribute 移到 TestMethodAttribute。
19. ConditionBaseAttribute.ShouldRun 重命名为 IsConditionMet。
20. 内部化/移除的类型：MSTestDiscoverer、MSTestExecutor、AssemblyResolver、LogMessageListener、TestExecutionManager、TestMethodInfo、TestResultExtensions、UnitTestOutcomeExtensions、GenericParameterHelper、PlatformServices 程序集中的 ITestMethod（TestFramework 中的不变）；若引用到需找替代方案或移除依赖。
21. 处理行为变更：AppDomain 默认禁用（DisableAppDomain 默认 true），如需显式控制 AppDomain 隔离，在 .runsettings 的 RunConfiguration 中设 <DisableAppDomain>false</DisableAppDomain>。
22. TestContext 生命周期作用域收紧：FullyQualifiedTestClassName 不能在 [AssemblyInitialize] 访问，TestName 不能在 [AssemblyInitialize] 或 [ClassInitialize] 访问；把访问 TestName 的代码移到 [TestInitialize] 或测试方法中，不要用 FullyQualifiedTestClassName 替代（语义不同）。
23. TestCase.Id 生成算法变更：无需改代码，但 Azure DevOps 测试历史会重新基线。
24. TreatDiscoveryWarningsAsErrors 默认 true：发现警告会导致测试不被发现；优先修复警告，临时可在 .runsettings 的 <MSTest> 中设 <TreatDiscoveryWarningsAsErrors>false</TreatDiscoveryWarningsAsErrors>。
25. MSTest.Sdk 与 vstest.console 兼容性：v4 的 MTP 模式不再附带 Microsoft.NET.Test.Sdk，导致 vstest.console 可能发现 0 个测试。方案 A：显式添加兼容版本的 Microsoft.NET.Test.Sdk（中央包管理时在 Directory.Packages.props 加 PackageVersion，项目引用保持无版本），并用实际 vstest.console 命令验证；方案 B：设 <UseVSTest>true</UseVSTest> 切到 VSTest 模式；方案 C：把 CI 的 vstest.console 调用改为 dotnet test（MTP 原生，推荐长期方案）。
26. 分析器严重级别变更：MSTEST0001、MSTEST0007、MSTEST0017、MSTEST0023、MSTEST0024、MSTEST0025、MSTEST0030、MSTEST0031、MSTEST0032、MSTEST0035、MSTEST0037、MSTEST0045 默认从 Info 升为 Warning；修复新警告或在 .editorconfig 中抑制。
27. 验证：运行 dotnet build 确认零错误并检查新警告；运行 dotnet test 确认全部通过；与迁移前基线对比通过/失败数量；确认没有测试因更严格的发现规则被静默丢弃；若用 Azure DevOps 跟踪，注意 TestCase.Id 变更影响历史连续性。
28. 最终报告：给出检测到的 v3 版本、解析出的 v4 版本、runner 选择、改动文件、实际构建/测试计数；不要凭推断报告构建、VSTest 兼容性、发现结果或测试通过。

适用边界 · 注意事项

• 项目已经使用 MSTest v4 且构建干净——迁移已完成
• 从 MSTest v1 或 v2 升级——先用 migrate-mstest-v1v2-to-v3，再回到本技能
• 项目不使用 MSTest，或在测试框架之间迁移（如 MSTest 转 xUnit/NUnit）