Azure DevOps YAML无法从props文件读取.NET版本的问题排查

NETSDK1013错误的核心原因是通用TestArchetype.props文件未被正确导入，导致TargetFramework属性未被设置。本地VS2022和Rider能正常构建，是因为IDE会自动初始化$(SolutionDir)变量并正确解析props文件路径；但Azure DevOps流水线中直接用dotnet test指定单个csproj文件时，$(SolutionDir)可能未被正确赋值，或者路径解析出现偏差，最终导致props文件导入失败，TargetFramework为空。

以下几种方法都可以解决问题，根据你的项目结构选择最适合的方式：

1. 改用相对路径导入props文件 #

将csproj中的$(SolutionDir)替换为相对于当前csproj文件的路径，确保无论在哪个环境下都能正确定位到props文件。

比如你的测试项目位于ApiGateway/Api/Consumer.HooksApi.Tests/，而Archetypes文件夹在解决方案根目录，修改后的csproj导入语句如下：

<Project Sdk="Microsoft.NET.Sdk">
    <!-- 替换为相对路径，层级根据实际项目结构调整 -->
    <Import Project="../../../Archetypes/TestArchetype.props" />

    <PropertyGroup>
        <ImplicitUsings>enable</ImplicitUsings>
        <Nullable>enable</Nullable>

        <IsPackable>false</IsPackable>
        <IsTestProject>true</IsTestProject>
    </PropertyGroup>

    ...
</Project>

2. 在流水线中显式设置SolutionDir属性 #

Azure DevOps中$(Build.SourcesDirectory)对应代码仓库的根目录（即本地的SolutionDir），在dotnet test的参数中显式传递该变量，确保props文件路径解析正确。

修改后的YAML测试任务：

- task: DotNetCoreCLI@2
    displayName: "Run unit tests"
    inputs:
        command: "test"
        arguments: '-c $(BuildConfiguration) --filter TestCategory!~Integration -property:NoWarn="1701%3B1702%3B1591" -property:SolutionDir=$(Build.SourcesDirectory)/'
        projects: |
            ApiGateway/**/*.Tests.csproj
            Shared/**/*.Tests.csproj

注意：SolutionDir结尾必须加斜杠，和本地IDE的行为保持一致，避免路径拼接错误。

3. 针对解决方案文件执行测试 #

如果你的项目有对应的.sln文件，直接指定解决方案文件执行测试，这样dotnet会自动处理SolutionDir变量，完全对齐本地IDE的构建逻辑。

修改后的YAML测试任务：

- task: DotNetCoreCLI@2
    displayName: "Run unit tests"
    inputs:
        command: "test"
        arguments: '-c $(BuildConfiguration) --filter TestCategory!~Integration -property:NoWarn="1701%3B1702%3B1591"'
        projects: 'YourSolutionName.sln' # 替换为实际的解决方案文件名

额外优化（可选） #

为了让props文件的条件判断更健壮，可以修改TargetFramework的Condition，覆盖空字符串的边缘情况：

<TargetFramework Condition="'$(TargetFramework)' == '' Or '$(TargetFramework)' == '$([System.String]::Empty)'">net8.0</TargetFramework>

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