Sitefinity使用.Net Core模板时页面编辑器无显示问题

• 基于Sitefinity官方Git仓库提供的QuantumLayout测试新版.NET Core Renderer
• 部署架构：Sitefinity实例部署在Azure云服务器，开发阶段.NET Core Renderer本地托管，为跨环境混合部署模式，后续计划将渲染器部署至同一服务器
• 异常表现：直接打开Core模板对应的页面编辑器时无任何内容展示，切换到模板预览模式则内容可正常显示

• 跨域请求被浏览器拦截：Sitefinity页面编辑器加载Core渲染内容时，是在Azure站点的编辑页域下，直接向本地运行的渲染器发起带身份凭证的请求，本地渲染器默认未配置对应CORS策略，浏览器直接拦截该类跨域带凭证请求，导致编辑区内容拉取失败；预览模式下内容拉取走Sitefinity服务端请求链路，不触发浏览器跨域限制，因此可以正常展示
• 渲染器可信主机校验拦截：.NET Core Renderer默认会校验发起编辑渲染请求的来源主机，未在白名单内的主机请求会被直接拒绝返回空内容，当前本地渲染器未将Azure上的Sitefinity实例域名加入可信白名单，导致编辑模式的片段请求被拦截
• 路径配置不匹配：QuantumLayout默认使用同域路径引用静态资源、组件接口，混合部署模式下编辑模式会默认从Azure站点路径请求本地渲染器的资源与接口，路径不匹配导致资源加载失败，编辑区空白
• 版本兼容问题：如果Sitefinity实例与本地渲染器的版本号不一致，QuantumLayout依赖的内置组件序列化结构不兼容，也会导致编辑模式渲染返回空，预览模式因为兼容性校验逻辑更宽松不会触发该问题

1. 配置渲染器CORS策略
   打开本地渲染器项目的Program.cs文件，添加跨域策略配置，允许Azure Sitefinity实例的域名跨域带凭证访问，参考配置如下：

   const string sitefinityAzureOrigin = "https://替换为你自己的Azure Sitefinity实例域名";
   builder.Services.AddCors(opts =>
   {
       opts.AddPolicy("EditorAllowCors", policy =>
       {
           policy.WithOrigins(sitefinityAzureOrigin)
                 .AllowCredentials()
                 .AllowAnyHeader()
                 .AllowAnyMethod();
       });
   });
   
   // 注意中间件顺序，放在UseRouting之后，UseAuthorization、MapControllerRoute之前
   app.UseRouting();
   app.UseCors("EditorAllowCors");
   app.UseAuthorization();
   

2. 配置渲染器可信主机白名单
   打开本地渲染器项目的appsettings.json，找到Sitefinity配置节点，将Azure Sitefinity实例的完整域名（不带末尾斜杠）加入AllowedSitefinityHosts数组，同时确认DisablePageEditMode配置为false
3. 配置Sitefinity端渲染器地址
   登录Sitefinity后台，进入高级设置找到.NET Core Renderer配置项，将本地运行的渲染器HTTPS地址（例如https://localhost:7254）填入RendererBaseUrl字段，保存后重启Sitefinity应用

   注意本地渲染器必须启用HTTPS，否则浏览器会拦截HTTPS站点（Azure上的Sitefinity默认启用HTTPS）加载HTTP本地资源的请求

4. 版本一致性校验
   确认本地渲染器安装的NuGet包版本，和Azure上部署的Sitefinity实例内部版本号完全一致，避免组件序列化不兼容问题
5. 验证
   清除浏览器对应Sitefinity站点的Cookie与缓存，重启本地渲染器后重新进入页面编辑器，打开开发者工具网络面板，确认到本地渲染器的/render、/sf/system等接口请求返回200状态码，无跨域、资源加载报错即可

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