如何配置可IIS调试的前后端应用共享同一应用池并部署Azure？

1. 调整项目结构 #

• 解决方案根目录下新建两个文件夹：Frontend（存放前端所有静态资源，比如index.html、js、css包等）和Backend（放置你的ASP.NET Core后端项目文件）
• 确保后端项目的.csproj文件在Backend文件夹内，前端资源直接放在Frontend根目录，不要嵌套子文件夹

2. 配置解决方案根目录的web.config #

这个配置会优先把/api/*路径的请求交给后端处理，其余所有请求转发给前端静态文件，同时规避IIS应用冲突问题：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <!-- 所有/api开头的请求转发到后端项目 -->
        <rule name="API Route" stopProcessing="true">
          <match url="^api/(.*)" />
          <action type="Rewrite" url="Backend/{R:0}" />
        </rule>
        <!-- 非文件/非目录的请求，转发到前端index.html（适配单页路由） -->
        <rule name="Frontend SPA Route" stopProcessing="true">
          <match url="^(.*)$" />
          <conditions>
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
          <action type="Rewrite" url="Frontend/index.html" />
        </rule>
      </rules>
    </rewrite>
    <!-- 配置ASP.NET Core模块处理后端请求 -->
    <handlers>
      <add name="aspNetCore" path="Backend/*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      <add name="StaticFile" path="*" verb="*" modules="StaticFileModule,DefaultDocumentModule,DirectoryListingModule" resourceType="Either" requireAccess="Read" />
    </handlers>
    <aspNetCore processPath="dotnet" arguments=".\Backend\你的后端项目名称.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
    <!-- 设置默认首页为前端index.html -->
    <defaultDocument>
      <files>
        <clear />
        <add value="Frontend/index.html" />
      </files>
    </defaultDocument>
  </system.webServer>
</configuration>

注意：把代码里的你的后端项目名称.dll替换成实际编译后的后端DLL文件名。

3. 配置Visual Studio调试的launchsettings.json #

修改后端项目的launchsettings.json，让IIS Express调试时指向解决方案根目录，而非后端项目目录：

{
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:5000",
      "sslPort": 5001,
      "physicalPath": "你的解决方案根目录绝对路径" // 示例："C:\\Code\\YourSolutionRoot"
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "Backend": {
      "commandName": "Project",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      },
      "applicationUrl": "https://localhost:7001;http://localhost:5001"
    }
  }
}

这样配置后，IIS Express会把解决方案根目录作为站点根目录，不会再提示根路径存在其他应用。

4. Azure部署适配 #

• 部署时直接上传整个解决方案根目录到Azure App Service的site/wwwroot目录
• Azure App Service会自动识别根目录的web.config，默认共享同一应用池，无需额外配置
• 确保后端编译后的DLL和依赖文件都在Backend文件夹内，前端静态文件完整放在Frontend文件夹

关键注意事项 #

• 本地调试时，确保你的IIS服务器已经安装URL Rewrite模块（Azure App Service默认自带，本地需手动下载安装）
• 完全规避后端代码中使用UseStaticFiles()，前端由IIS静态文件模块独立托管，不依赖.NET运行时
• 如果调试时仍出现应用冲突，检查IIS Express的站点配置，确保只有当前解决方案的站点指向该根目录

内容的提问来源于stack exchange，提问作者Kyoshiro Kokujou Obscuritas