GitHub Runner构建时出现MSB3103：无效Resx文件错误求助

问题背景 #

将旧WinForms项目转换为新版SDK格式csproj后，本地构建运行正常，但在基于Windows Server 2022的自定义GitHub Windows Runner上构建时，大量Resx文件触发error MSB3103: Invalid Resx file. The specified module could not be found错误，涉及两类场景：

• 仅包含窗体图标资源的Resx（图标为项目根目录下的.ico文件）
• 包含文件对话框.TrayLocation属性的Resx

旧版csproj中显式配置了Resx的EmbeddedResource及DependentUpon关联，新版SDK格式无相关配置。

修复方案 #

1. 显式配置Resx的嵌入式资源关联 #

新版SDK默认的自动处理逻辑可能未正确关联窗体与Resx文件，需在csproj中添加显式配置，对齐旧版的依赖关系：

<ItemGroup>
  <!-- 关联所有与窗体cs文件同名的Resx -->
  <EmbeddedResource Include="**\*.resx" Condition="Exists('%(Filename).cs')">
    <DependentUpon>%(Filename).cs</DependentUpon>
    <Generator>ResXFileCodeGenerator</Generator>
    <LastGenOutput>%(Filename).Designer.cs</LastGenOutput>
  </EmbeddedResource>
</ItemGroup>

2. 确保图标文件在构建环境中可访问 #

• 在csproj中配置图标文件的复制规则，保证Runner构建时能获取到文件：

<ItemGroup>
  <Content Include="*.ico">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

• 检查Resx中图标引用路径，确保使用相对路径（而非绝对路径），避免因Runner环境目录结构差异导致找不到文件。

3. 解决.TrayLocation属性依赖问题 #

.TrayLocation属性依赖Windows桌面相关组件，基础版Windows Server 2022默认未安装，可通过两种方式处理：

• 若该属性非必要，直接编辑Resx文件删除对应的TrayLocation条目；
• 申请在自定义Runner上安装Windows Desktop Experience功能组件，补足托盘相关系统依赖。

4. 对齐本地与Runner的MSBuild/构建工具版本 #

本地构建正常但Runner报错，可能是版本差异导致的解析逻辑不同：

• 确认本地使用的MSBuild版本（如Visual Studio 2022对应MSBuild 17.x）；
• 申请在Runner上安装同版本的Visual Studio Build Tools，保证构建环境一致性。

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