为什么我的.NET 6应用运行时要求安装.NET 6 SDK？

问题核心成因是构建产物携带了仅SDK包含、.NET 运行时（Runtime）未携带的程序集/构建组件引用，本地运行正常是因为开发环境已安装SDK，用户侧仅装Runtime时缺失对应文件就会触发安装SDK的提示。 #

1. 从发布产物的依赖清单直接定位 #

不要用本地调试的bin/Debug目录排查，必须用正式发布的产物做检查：

• 执行框架依赖模式的发布命令：dotnet publish -c Release -r win-x64 --self-contained false
• 打开发布目录下与游戏exe同名的.deps.json文件，全局搜索Sdk关键字，筛选出路径包含/sdk/、属性标记为"type": "sdk"的程序集条目，这些就是非运行时的SDK依赖项
• 检查发布目录内是否存在.targets、.props等MSBuild配置文件，这类文件仅在构建阶段使用，运行时不需要，出现在发布目录就说明依赖配置错误

2. 逐一排查高概率问题依赖 #

你列出的依赖里，几个常见的SDK依赖来源如下：

• Grpc.Tools：这是纯构建时工具包，作用是编译阶段自动生成Protobuf序列化代码，运行时完全不需要。如果包引用没配置私有资产规则，就会被错误标记为运行时依赖，强制要求SDK环境。修复方式是修改包引用配置：

<PackageReference Include="Grpc.Tools" Version="你的包版本">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>build; analyzers</IncludeAssets>
</PackageReference>

• Grpc.AspNetCore：这是ASP.NET Core服务端专属包，依赖Web SDK的大量专属组件，如果你的游戏是纯客户端程序，直接移除该引用，仅保留Grpc.Net.Client即可
• System.Management、System.Drawing.Common：如果是手动从本地SDK安装目录添加的dll引用，而非通过NuGet安装的正式运行时包，会直接依赖SDK路径下的文件，卸载重装对应NuGet包即可修复
• System.Data.SQLite：确认安装的是带原生互操作层的正式运行时包，不要引用SDK目录下附带的构建用测试版本

3. 用工具精准定位缺失依赖 #

• 打开Visual Studio开发人员命令提示符，进入发布目录，执行dotnet list <你的游戏主程序名>.deps.json reference，命令会列出所有运行时需要加载的程序集来源，所有来源路径指向本地dotnet/sdk目录的条目就是问题项
• 在仅安装.NET 6 Runtime、未安装SDK的测试机/虚拟机上启动游戏，用Process Monitor抓取进程启动阶段的文件访问日志，过滤结果为NAME NOT FOUND的条目，直接看游戏尝试加载的、属于SDK目录的缺失文件，即可100%定位来源

4. 检查项目配置的隐性问题 #

• 检查所有项目的.csproj文件开头的SDK声明：普通客户端/类库项目使用Microsoft.NET.Sdk，WinForms/WPF项目使用对应Windows桌面SDK，非服务端项目不要引用Microsoft.NET.Sdk.Web
• 临时关闭PublishReadyToRun、PublishTrimmed等特殊发布优化选项，重新发布测试，排除编译优化误引入SDK依赖的情况
• 全局搜索代码，确认没有动态加载Microsoft.Build.*、Microsoft.NET.Sdk.*这类仅SDK包含的程序集

排查注意：所有验证必须在只装了.NET 6 Runtime的干净环境做，开发环境因为存在SDK全局程序集缓存，会自动补全缺失依赖，无法复现用户侧问题。

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