Optimizely 11升级至12后站点及全局资源加载异常求助

• 检查站点URL配置
  确认appsettings.json中的EPiServer:CMS:SiteUrl是否设置为带端口的完整地址：

  "EPiServer": {
    "CMS": {
      "SiteUrl": "https://loca.dummy.com:7047"
    }
  }
  

  这个配置直接影响媒体资源URL的生成，若未指定端口，生成的URL会缺失端口号导致无法访问。

• 验证静态文件中间件配置
  Optimizely 12依赖ASP.NET Core的静态文件中间件处理媒体资源，确保Program.cs中正确添加且顺序无误：

  var builder = WebApplication.CreateBuilder(args);
  // 添加Optimizely服务...
  var app = builder.Build();
  
  // 静态文件中间件需放在路由之前
  app.UseStaticFiles();
  app.UseRouting();
  // 其他中间件（如认证、授权）...
  app.UseEndpoints(endpoints =>
  {
      endpoints.MapContent();
      endpoints.MapRazorPages();
  });
  

  若站点资产使用了自定义物理路径，需在UseStaticFiles中配置对应的映射规则。

• 确认资源存储路径与权限

  • 检查wwwroot/siteassets（站点资产）和wwwroot/globalassets（全局资源）目录是否存在，且媒体文件确实存储在对应路径下。
  • 确保应用程序池用户对这些目录拥有读取权限，权限不足会导致文件无法被读取返回空白。
  • 核对后台站点配置中的Site Assets Root路径，需与物理存储路径一致。

• 排查自定义URL解析逻辑
  若项目中有自定义的媒体URL生成代码（如自定义UrlResolver实现），需适配Optimizely 12的API变更。检查是否存在硬编码旧域名/端口的情况，这类代码在升级后会导致URL生成错误。

• 调试请求与日志

  • 用浏览器开发者工具查看媒体资源请求的Network面板，确认请求的URL是否正确、状态码是什么（即使页面空白，可能是200但无内容，或404被处理为空白）。
  • 启用Optimizely调试日志，在appsettings.json中添加：

    "Logging": {
      "LogLevel": {
        "EPiServer.CMS.Core": "Debug",
        "EPiServer.Framework": "Debug"
      }
    }
    

    查看日志文件中是否有媒体资源加载相关的错误提示，比如文件找不到、权限异常等。

• 刷新媒体项与站点配置
  在Optimizely后台重新发布所有媒体项，或重新保存站点配置，触发系统刷新媒体URL的缓存。

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