Asp.Net Core子应用由于配置中重复添加模块会引起IIS错误500.19

南天一柱

　　ASP.NET Core已经从IIS中解耦，可以作为自宿主程序运行，不再依赖IIS。
　　但我们还是需要强大的IIS作为前置服务器，IIS利用httpPlatformHandler模块来对后台的一些web服务器进行进程管理，比如Tomcat, Jetty, Node.exe, Ruby，当然还有dotnet，同时为它们代理分发网络请求。
　　httpPlatformHandler是通用的、闭源的，而且貌似迭代的很慢，半年了还停留在带着一个大BUG的v1.2，可能是由于这些原因吧，.NET小组从httpPlatformHandler分支出来一个专门针对dotnet的版本，改名为AspNetCoreModule并且准备把它开源，这样应该能更好地适应.NET Core的发展。
　　那么要使用IIS，则web.config是必须的，所以我们看到项目文件里的web.config是这样配置的：



<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.webServer>
<handlers>
<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified"/>
</handlers>
<aspNetCore processPath="dotnet" arguments=".\WebApplication6.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false" />
</system.webServer>
</configuration>
　　很好理解，<add ../> 添加了一个AspNetCoreModule模块，名字为"aspNetCore"，后面的<aspNetCore .. /> 则对这个模块的必要参数进行简单配置。
　　这样就告诉了IIS，在处理这个站点/应用的时候，使用aspNetCore这个模块，而这个模块则会启动dotnet并分发请求。
　　不过，当我们在一个ASP.NET Core的站点下增加一个ASP.NET Core子应用的时候，

　　访问这个子应用会得到500.19错误：

　　HTTP 错误 500.19
　　错误代码：0x800700B7
　　配置错误：在唯一密钥属性“name”设置为“aspNetCore”时，无法添加类型为“add”的重复集合项

　　查看这个子应用程序的配置，无法显示system.webServer/handlers节点，提示的错误和上图500.19中的配置错误一致：

　　我们很容易想到，主站点的web.config里已经使用了"aspNetCore"这个名字，那么子应用就不能再用了。
　　试着修改subapp1的web.config，将"aspNetCore"随便改成其他的名字：



<add name="aspNetCore123" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified" />
　　这时再访问 /subapp1 就一切正常了。
　　但是这样改名字并不是一个正确的方法：

　　提示这种错误是IIS本身一个正常的行为，因为在“website”站点根目录的web.config里，已经用<add ../>添加了模块AspNetCoreModuel了，在子应用里实际上不再需要<add ../>来添加这个模块了，但是任然需要下面的<aspNetCore ../>来进行配置。
　　所以正确的做法是，在一个站点里，只在根目录web.config里保留<add ../>添加模块，其他子应用程序，都把这一节删除就可以了，即：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.webServer>   
<aspNetCore processPath="dotnet" arguments=".\WebApplication6.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false" />
</system.webServer>
</configuration>
　　经@calvinK 提醒，更妥善的办法是先删除，再添加：



<?xml version="1.0" encoding="utf-8"?>
<configuration>      
<system.webServer>   
<handlers>
<remove name="aspNetCore"/>
<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified" />
</handlers>
<aspNetCore processPath="dotnet" arguments=".\WebApplication6.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false" />
</system.webServer>
</configuration>
　　ps：可以加群 48082039 讨论C#,asp.net core相关话题。