ASP.NET Core Web API 发布到 IIS 服务器
本文介绍了在VS2022中创建和发布ASP.NET Core Web API项目的完整流程。首先通过右键项目选择发布功能生成发布文件,然后在IIS中创建对应的应用程序池和网站。文章重点说明了安装ASP.NET Core运行时Hosting Bundle的必要性,以及如何通过Postman等工具测试API接口。整个过程涉及IIS配置、运行时环境安装和路由访问等关键步骤,并提示了可能遇到的问题及解决方
目录
在 VS 2022 中,创建一个 ASP.NET Core Web API 项目,项目我就使用默认的代码,没有添加任何代码,也没修改任何配置文件,系统我使用的是我自己的电脑,Win11 系统,如果是 Windows 服务器系统,比如:Windos Server,用法也大差不差。
至于如何创建项目,可以看看我之前的帖子:
https://blog.csdn.net/qq_38693757/article/details/127024492?spm=1001.2014.3001.5502
目前我创建的项目用的是 .NET 9,可能有一些差异,如果不知道怎么用,直接默认就好了
一、发布项目
鼠标右键点击项目,选择发布



这里点击修改,必须要修改,不要使用默认的选项

修改后点击保存

点击发布

在项目的 bin --> Reslease --> net9.0 --> public 你就能看到发布好的文件
路径千万不能搞错了,否则后面在 IIS 上发布会出问题。

二、创建应用程序池
打开 IIS 管理器

添加应用程序池

这里的名称就写你项目的名字,版本这里选择 无托管代码

点击确定,这里比较简单,但也是必要的步骤。
三、创建网站
接着需要添加一个网站

这里的 网站名称 和刚刚创建的 应用程序池 一样
物理路径就是发布的文件夹,你可以将 public 复制出来放在其他的文件夹下,因为网站启动后,原地址的文件就不能修改了,会导致你的 VS 项目无法发布
端口这里随意,只要不冲突就行,不必和 VS 中的配置文件 launchSettings.json 端口号一样

这个时候,如果你点击 浏览

结果就会发现根本不能使用
四、解决错误
这个错误就是没装 ASP.NET Core 运行时,安装了就好了

打开下面的地址:
https://dotnet.microsoft.com/zh-cn/download/dotnet
选择 .NET 9(根据你实际使用的 .NET 版本号)

这时候会有非常多的选项,选择 ASP.NET Core 运行时 Hosting Bundle

下载完成后,点击安装

安装成功后,需要重启 IIS 服务,我们找到服务 --> IIS 管理服务,将其重新启动
windows server 应该没有这个服务,你可以忽略这个步骤。

但是 浏览 *:5246(http) 这里依然是无效的,这很正常,因为你的地址没有访问到项目中的路由地址

或者,你需要在 Program.cs 中修改代码,这样使用 http://localhost:5246/ 一样可以访问到一个默认的路由地址,就可以得到对应的回应了。
点击 你的 IIS 网站项目,双击鼠标左键进入 模块

如果你看到 AspNetCoreModuleV2 这一项,说明 Hosting Bundle 安装成功了

这个时候,需要 打开 Postman 或者 Apifox(国产软件)
使用正确的地址 + 路由 ,就能正常的使用了

如果出现了 HTTP Error 500.30 - ASP.NET Core app failed to start 错误,以下可能是解决方案:
尝试将 web.config 文件中的 hostingModel 设置为 outofprocess,或删除该属性:
<aspNetCore processPath="dotnet" arguments=".\你的项目名称.dll" hostingModel="outofprocess" />
.NET 不同的版本,发布后的差异比较大,比如你用的是 .NET 6 发布的,看的却是 .NET 9 的教程,这会导致项目出现严重的问题,配置文件也不要随意的修改。
end
更多推荐




所有评论(0)