.NET 8.0可执行文件运行异常：exe报错但dll可正常运行

API 探路者

2026-6-19

解决.NET 8.0 Web项目exe运行提示需安装.NET Framework的问题

问题根源

使用Microsoft.NET.Sdk.Web构建的.NET 8.0项目，直接运行生成的foo.exe时触发.NET Framework安装提示，但dotnet run foo.dll正常运行，且.NET 7.0版本无此问题。核心原因是.NET 8.0对Web项目的可执行文件引导逻辑做了调整，或系统中.NET Runtime的关联/安装不匹配。

解决步骤

检查并补全.NET Runtime安装
运行以下命令查看已安装的Runtime：
```
dotnet --list-runtimes
```
确保同时存在Microsoft.NETCore.App 8.0.x和Microsoft.AspNetCore.App 8.0.x版本（Web项目依赖ASP.NET Core Runtime）。若缺少后者，下载对应版本的ASP.NET Core Runtime安装即可。
显式指定Runtime标识符（RID）构建
在项目的csproj中添加RuntimeIdentifier配置，针对Windows x64环境示例：
```
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
</PropertyGroup>
```
重新构建项目后，生成的exe会绑定指定的系统架构，避免运行时的环境误判。
修复.NET安装关联
运行以下命令修复.NET的系统关联和安装完整性：
```
dotnet --repair
```
该命令会自动修复文件关联、Runtime注册等问题，解决exe无法正确识别.NET Runtime的情况。
切换为自包含发布模式（可选）
若希望exe不依赖系统中的.NET Runtime，可在csproj中添加自包含配置：
```
<PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <SelfContained>true</SelfContained>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
</PropertyGroup>
```
发布时会将.NET Runtime和项目文件打包在一起，直接运行exe即可，无需系统提前安装.NET。