ASP.NET Core Sitefinity渲染器无法运行，请求故障排查

以下是针对该问题的分步排查方案：

1. 确认Sitefinity CMS实例正常运行 #

• 直接访问本地CMS地址（https://localhost:5001或http://localhost:5000），确保能正常打开后台管理界面和前端站点页面，无启动失败、证书警告等异常。

2. 核对appsettings.json核心配置 #

• Sitefinity.Url配置：确保地址与CMS实际运行地址完全一致，比如HTTPS地址需完整写https://localhost:5001，末尾不要加多余斜杠或路径；
• Sitefinity.ApiKey配置：检查是否在CMS后台生成了有效的API密钥，并准确复制到渲染器配置中，密钥不匹配会导致API请求授权失败，返回空白；
• Sitefinity.DefaultSiteName配置：确认该值与CMS中创建的站点名称完全一致（大小写敏感），名称错误会导致渲染器无法找到对应站点内容。

3. 查看日志与网络请求 #

• 启动渲染器时，观察控制台输出日志，查找是否有401（未授权）、404（站点/资源不存在）等错误提示；
• 打开浏览器开发者工具（F12），切换到网络标签，访问渲染器页面时，查看是否有向CMS发送API请求，检查请求的状态码和返回内容：
  • 若返回401：优先排查API密钥是否正确；
  • 若返回404：检查站点名称或CMS地址配置是否有误；
  • 若无请求发送：排查渲染器服务与中间件配置是否正确。

4. 验证Program.cs配置正确性 #

• 确认已正确添加渲染器服务：builder.Services.AddSitefinityRenderer()，并通过配置项传入正确的API密钥、站点名称等参数；
• 检查中间件顺序：app.UseSitefinityRenderer()需放在app.UseRouting()之后、app.UseEndpoints()之前，中间件顺序错误会导致渲染逻辑不生效。

5. 处理HTTPS证书信任问题 #

• 若CMS使用HTTPS协议，运行命令dotnet dev-certs https --trust信任本地开发证书，避免渲染器调用CMS API时因证书不被信任而请求失败，完成后重启渲染器和CMS实例。

6. 检查CMS页面与模板配置 #

• 确认CMS中目标页面已切换为ASP.NET Core渲染器模板，而非默认的WebForms模板；
• 确保页面已发布，未发布的页面无法在渲染器中正常显示。

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