如何将基于.NET Framework的Angular合并版ABP模板部署到IIS

你已经完成了前期的发布包创建和基础网站配置，接下来咱们把剩余的关键步骤补全，确保项目能稳定运行：

1. 修正Web.Host的发布路径指向 #

你之前把IIS网站直接指向了wwwroot目录，这是个小误区——ABP合并版的后端服务依赖Web.Host发布根目录下的web.config、appsettings.json等核心配置文件，所以需要调整：

• 打开IIS管理器，找到你的网站，右键选择「基本设置」，把物理路径修改为Web.Host的发布根目录（也就是包含wwwroot文件夹的那个上级目录）。

2. 确认Web.config的路由规则 #

ABP模板通常自带Angular路由的重写规则，但建议检查发布后的web.config，确保system.webServer节点下有这段配置（如果没有就手动添加）：

<rewrite>
  <rules>
    <rule name="Angular Routes" stopProcessing="true">
      <match url=".*" />
      <conditions logicalGrouping="MatchAll">
        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
      </conditions>
      <action type="Rewrite" url="/" />
    </rule>
  </rules>
</rewrite>

这个规则是为了避免Angular单页应用刷新页面时出现404错误。

3. 完善appconfig.json配置 #

你已经修改了wwwroot/assets/appconfig.json，请确保配置完整且参数正确：

{
  "remoteServiceBaseUrl": "http://localhost:8081",
  "appBaseUrl": "http://localhost:8081",
  "localeMappings": [
    {
      "from": "en",
      "to": "en-US"
    }
  ]
}

这里两个地址保持一致即可，因为是前后端合并部署的模式。

4. 配置IIS应用程序池 #

找到网站对应的应用程序池，右键选择「高级设置」，调整以下关键项：

• 将**.NET CLR版本**设置为v4.0.30319（适配完整.NET Framework项目）；
• 将托管管道模式设置为集成；
• 检查标识权限：如果用本地SQL Server数据库，可以先临时设置为LocalSystem测试（后续建议改成低权限账户），确保应用池账户能访问发布目录和数据库。

5. 验证数据库连接配置 #

打开发布根目录下的appsettings.json，确认ConnectionStrings里的连接字符串正确，比如：

"ConnectionStrings": {
  "Default": "Server=.;Database=YourProjectDb;Trusted_Connection=True;MultipleActiveResultSets=true"
}

如果是SQL Server身份验证，要确保用户名、密码正确，且该账户拥有数据库的读写权限。

6. 测试部署效果 #

• 启动IIS网站，访问http://localhost:8081，能看到ABP登录页面说明前端部署成功；
• 测试API接口：访问http://localhost:8081/api/abp/application-configuration，返回JSON数据则表示后端API正常；
• 用默认管理员账号（通常是admin/123qwe）尝试登录，能进入后台系统就代表整个部署流程完成。

常见问题排查 #

• 出现500错误：查看IIS事件查看器，或者发布目录下的Logs文件夹，排查具体错误（比如数据库连接失败、权限不足）；
• 前端路由刷新404：确认web.config的重写规则正确，并且IIS已安装URL Rewrite模块（可通过IIS管理器的「Web平台安装程序」搜索安装）；
• API接口404：再次确认物理路径指向的是Web.Host发布根目录，而非wwwroot。

内容的提问来源于stack exchange，提问作者Mohammad Shadmehr