Optimizely CMS12部署IIS遇404问题求助

应用程序池核心配置检查 #

• 确认应用程序池的**.NET CLR版本**设置为无托管代码，.NET Core应用依赖自托管模式，IIS仅作为反向代理，无需托管代码支持
• 检查应用程序池身份：优先使用ApplicationPoolIdentity，并给站点根目录添加IIS AppPool\[你的应用池名称]的读/执行权限，避免过度开放Everyone权限
• 验证32位应用程序设置：若项目编译目标为x86，需开启应用程序池的“启用32位应用程序”选项；64位环境保持默认关闭即可

IIS站点与模块配置 #

• 核对站点绑定与hosts映射：确保IIS站点绑定的主机名、端口与本地C:\Windows\System32\drivers\etc\hosts文件中的映射一致，访问时严格使用绑定的主机名
• 确认.NET Core Hosting Bundle安装状态：在IIS的模块列表中检查是否存在AspNetCoreModuleV2，缺失则重新安装与项目目标.NET版本匹配的托管捆绑包（CMS12推荐.NET 6/7）
• 检查处理程序映射：确认站点的处理程序映射中存在AspNetCore条目，路径为*，关联模块为AspNetCoreModuleV2

部署文件与发布配置 #

• 验证web.config配置：确保发布目录包含web.config，且aspNetCore节点配置正确，示例：

  <aspNetCore processPath="dotnet" arguments=".\YourOptimizelySite.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
  

• 匹配目标运行时与服务器环境：发布时选择对应服务器架构的目标运行时（如64位服务器选win-x64），部署模式可选择框架依赖（需服务器安装对应.NET运行时）或独立（自带运行时，无需服务器额外安装）
• 修正目录权限：移除给Everyone的全权限，添加IIS AppPool\[应用池名称]的读取和执行、列出文件夹内容、读取权限，遵循最小权限原则

Optimizely路由与中间件配置 #

• 确认路由配置：检查项目Program.cs（或Startup.cs）中是否正确添加Optimizely内容路由：

  app.UseEndpoints(endpoints =>
  {
      endpoints.MapContent();
  });
  

• 验证中间件顺序：确保app.UseEpiserver();在中间件管道中正确注册，且顺序在路由配置之前
• 测试后台路由：用绑定的主机名访问/util/login或/episerver/cms，若仍404，排查是否存在URL重写规则、防火墙或安全组拦截请求

日志定位错误 #

• 开启ASP.NET Core标准输出日志：修改web.config中stdoutLogEnabled="true"，指定stdoutLogFile路径，访问站点后查看生成的日志文件，获取具体错误信息
• 查看IIS请求日志：在C:\inetpub\logs\LogFiles目录下找到对应站点的日志，检查请求是否成功到达ASP.NET Core模块
• 检查Windows事件日志：打开事件查看器，在Windows日志>应用程序中筛选.NET Core相关事件，定位未捕获的异常或配置错误

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