VirtoCommerce Storefront Core部署至Azure出现500启动错误

从你提供的异常栈可以明确，问题出在VirtoCommerce.Storefront.Extensions.HostingEnviromentExtension.MapPath方法的第12行，触发了System.NullReferenceException，进而导致FileSystemBlobContentOptions配置失败，最终引发应用启动失败。下面是针对性的排查和修复步骤：

1. 修复MapPath方法的空引用问题 #

这个方法在处理路径映射时没有做空值校验，而Azure的生产环境中，路径参数或宿主环境属性可能出现预期外的空值。打开HostingEnviromentExtension.cs，修改MapPath方法：

public static string MapPath(this IHostingEnvironment hostEnv, string path)
{
    // 增加空值校验，避免空引用
    if (hostEnv == null)
        throw new ArgumentNullException(nameof(hostEnv));
    if (string.IsNullOrWhiteSpace(path))
        return hostEnv.ContentRootPath;
    
    // 统一处理路径分隔符，适配Azure的Windows路径格式
    var normalizedPath = path.TrimStart('~', '/', '\\');
    return Path.Combine(hostEnv.ContentRootPath, normalizedPath);
}

2. 修正FileSystemBlobContentOptions的路径配置 #

在Startup.cs第134行的配置逻辑中，确保路径映射正确。建议直接使用宿主环境的ContentRootPath拼接目标目录，同时可以通过环境变量灵活配置：

services.Configure<FileSystemBlobContentOptions>(options =>
{
    // 优先读取Azure应用设置中的环境变量，没有则使用默认路径
    var contentRoot = Environment.GetEnvironmentVariable("STOREFRONT_CONTENT_PATH") 
                      ?? hostEnv.MapPath("~/Content");
    options.RootPath = contentRoot;
});

如果需要自定义路径，你可以在Azure应用服务的配置>应用设置中添加STOREFRONT_CONTENT_PATH，值设为类似D:\home\site\wwwroot\Content的绝对路径。

3. 确保目标目录存在并拥有权限 #

Azure应用服务的文件系统中，如果Content目录不存在，会导致路径映射失败。可以在Startup.cs的Configure方法中添加自动创建目录的逻辑：

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    // 确保Content目录存在
    var contentPath = env.MapPath("~/Content");
    if (!Directory.Exists(contentPath))
    {
        Directory.CreateDirectory(contentPath);
    }
    
    // 其他原有配置逻辑...
}

4. 重新部署并验证 #

将修改后的代码重新部署到Azure，然后：

• 查看Azure的日志流，确认是否还有500错误
• 访问店面网站，检查是否能正常启动

这些步骤应该能解决你遇到的空引用异常问题，核心是处理路径映射的空值情况，同时适配Azure的生产环境路径格式。

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