关于.NET5在IIS中部署的几个问题总结

2022-04-11 16:15:14 浏览数 (1)

本来我的系列教程已经慢慢剥离开IIS了,毕竟有了Docker容器以后,配合Nginx使用真的很不错。但是还是有很多同学使用IIS的,这个不可否认IIS的重要性。随着.NET的发布,很多小伙伴已经开始升级了,我也就陆陆续续收到了一些问题咨询,问题也是说大不大,说小不小,像我这样很久都没有玩儿过IIS的,也就一两个小时就解决了,所以基础知识还是特别重要的。 同时,我也收到了一些质疑的声音: 比如.NET5的镜像有问题? 比如为什么要升级呀,又不是LTS? 鉴于这些问题,我想说和郭德纲老师的水洗煤发射火箭是同一类问题,我不是很懂,也没办法准确回答,具体请百度吧。

本文主要是列举几个这几天的问题,不会深入讲解原理什么的,很好理解的。

再次强调下,本文出现的不是.NET的Bug!!!,都是一些工具上的问题,只是一些弯路和尝试而已,因为这些情况,在3.1的时候也会有,只要细心的发现就能知道。

-01-IIS安装的问题 这里有两个问题,第一个安装IIS,都勾选哪几项,我为了测试效果,重装了我的某一台服务器:

然后安装下IIS,我这里很简单的勾选下这几项,不过也没有具体测试,是否可以更少的安装:

安装完IIS,系统里找不到,这确实偶尔会有这个小问题: 需要重启下,然后就可以在控制面板里找到:

关于IIS的安装就特别简单了,不多说了,下边说说重头戏。 下载运行时或者SDK,那为了演示效果,肯定我们在服务器里,只需要下载运行时是吧,毕竟不需要开发,或者命令行操作,如果你是用IIS的话,肯定不会再搞命令行了,基本都是本地拷贝上传到服务器的。 下载地址: https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-aspnetcore-5.0.0-windows-x64-installer 接下来就是部署站点了。

-02-IIS部署,出现500.19异常

首先,已知是项目已经在本地成功升级.net5,如果不会的话,可以看看我之前的文章《BCVP第2期:项目已完成升级.NET5.0》,然后本地开发已经能正常运行了,把发布后的文件上传到服务器。

关于这个异常,先来个异常截图,其实一般老手一眼就能看出来问题点:

没错,就是这个500.19 - Internal Server Error。

我之前写过一篇很全的升级3.1的文章:

https://www.cnblogs.com/laozhang-is-phi/p/beautifulPublish-mostBugs.html

这里讲了几乎所有升级3.1的时候遇到的问题,同样适用于5.0。

没错,就是没有安装指定的模块!测试方法,就是点击对应的站点,右侧功能区,点击模块,看看是否正常显示:

所以,就需要安装指定的模块了。

因为是.NET5,所以不仅需要安装运行时,还要安装HOST,省事儿的话,直接安装捆绑的包就行了:

https://dotnet.microsoft.com/download/dotnet/5.0

然后下载并安装:

安装完成后,可以在控制面板的程序中,查看到相应的结果:

如果提示重启的话,需要重启,接下来就可以在IIS中,点击模块,正常显示了:

是不是很熟悉,是不是很简单?

-03-IIS部署,出现异常502.5

刚刚我们已经安装了Host和Runtime,但是运行的时候还是出现了502.5,那是为什么?现在我还是把错误截图贴出来:

可以看到,是进程外启动失败,如果你看过我的视频,关于进程内和进程外的介绍,肯定会知道他们的区别。 进程外,其实就是关于Kestrel.exe的,进程内是w3wp.exe的,如果你之前的项目是3.1升级过来的,在发布的时候,会生成一个web.config,里边有关于进程启动的配置:

代码语言:javascript复制
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet" arguments=".Blog.Core.Api.dll" stdoutLogEnabled="false"
   stdoutLogFile=".logsstdout" hostingModel="OutOfProcess" />
    </system.webServer>
  </location>
</configuration>
<!--ProjectGuid: 6F47A41A-085E-4422-BB73-5A2CBAA07D9F-->

就是hostingModel,不知道有多少小伙伴在意过这个,这里官方默认的是OutOfProcess进程外的,但是如果你新建一个.net5的项目,它发布好后,默认的就是inprocess的,不信你自己可以看看。

这就导致了,部署的时候,报了进程外的异常,所以只需要把这里改成inprocess就行了,就可以一切正常。 如果你说,我就想要进程外的,可以!在服务器上安装对应的SDK就行了,记得有必要的话需要重启服务器的。 到这里,应该就没有什么问题了:

-04-.NET5.0 无法连接Oracle

这个也是这几天问的比较多的,我之前使用的Oracle不多,但是经过测试,发现了.NET5.0的Web项目连接Oracle的时候出异常,但是控制台却是可以的。

经过官方给建议,主要是ASP.NET5.0做了更高的安全验证:

这也就是说明了,为什么控制台会成功,而web项目会失败的原因。

更多内容,查看我提交的这个issue吧:

https://github.com/dotnet/aspnetcore/issues/27872

官方也很快的给出了解决方案和跟踪报告,横跨全球,六个小时就解决了,说实话真的很佩服,也很激励我的。

方案很简单,只需要在.net5的webapi项目的.csproj文件中,配置属性即可:

代码语言:javascript复制
<EnableUnsafeBinaryFormatterSerialization>true</EnableUnsafeBinaryFormatterSerialization>

想必都能看得懂,好啦,.NET5已经顺利的连上Oracle了,这种问题还是要和第三方沟通,因为不是.Net的问题的。

打完收工!

0 人点赞