ASP.NET Core 6 MVC使用ZipFile时视图失效的排查求助

我有一个用于测试文件查看功能的ASP.NET Core 6 MVC Web应用，在Visual Studio 2022本地环境中测试。

初始测试步骤 #

• 将示例文件example03.docx另存为.htm格式；
• 生成example03.htm文件和example03_files文件夹；
• 将文件和文件夹复制到/wwwroot/files目录；
• 在HomeController中添加ViewWordFile动作方法（见CODE #1）；
• 创建视图ViewWordFile.cshtml（见CODE #2）；
• 测试代码，运行正常。

问题描述 #

在将example03.htm及相关文件夹压缩为example03.zip后，尝试在ViewWordFile动作方法中解压文件时出现异常：

• 添加子文件夹/wwwroot/files/zipped和/wwwroot/files/unzip；
• 手动创建example03.zip并复制到/files/zipped目录；
• 在HomeController中添加UnpackFile解压方法（见CODE #3）；
• 修改ViewWordFile动作方法（见CODE #4）；
• 调试确认解压操作正常，文件已存入/files/unzip目录；
• 修改后ViewWordFile动作失效：调试可见视图已激活，但页面无内容显示，仍停留在首页；
• 移除ViewWordFile中调用解压方法的代码，直接使用/unzip目录中的文件，页面恢复正常，排除权限问题；
• 将ZipFile.ExtractToDirectory直接写入ViewWordFile动作（见CODE #5），问题重现，页面失效。

推测ZipFile方法干扰了视图的正常渲染，寻求故障排查建议或解决方案。

相关代码 #

CODE #1 #

public IActionResult ViewWordFile()
{
    return View();
}

CODE #2 #

@{
    ViewData["Title"] = "View Office File";
}

<div class="container">
    <h3>View MS Word Document</h3>
    <p>
    <div class="row text-center">
        <iframe src='https://localhost:7131/files/example03.htm' width='100%' height='650px' frameborder='0'></iframe>
    </div>
    </p>
</div>

CODE #3 #

private bool UnpackFile (string zipFile, string unzipDir)
{
    bool isOk = false;

    if (System.IO.File.Exists(zipFile))
    {
        ZipFile.ExtractToDirectory(zipFile, unzipDir, true);
        isOk = true;
    }

    return true;
}

CODE #4 #

public IActionResult ViewWordFile()
{
    string zipFile = Path.Combine(_hostEnv.WebRootPath, "files/zipped", "example03.zip");
    string unzipDir = Path.Combine(_hostEnv.WebRootPath, "files/unzip");
    UnpackFile(zipFile, unzipDir);

    return View();
}

CODE #5 #

public IActionResult ViewWordFile()
{
    string zipFile = Path.Combine(_hostEnv.WebRootPath, "files/zipped", "example03.zip");
    string unzipDir = Path.Combine(_hostEnv.WebRootPath, "files/unzip");
    ZipFile.ExtractToDirectory(zipFile, unzipDir, true);

    return View();
}

排查建议与解决方案 #

1. 检查文件锁定问题：ZipFile.ExtractToDirectory可能未及时释放文件句柄，导致视图加载时资源被占用。可尝试在解压后添加短暂延迟，或使用工具（如Process Explorer）检查文件是否被进程锁定。
2. 异步处理解压操作：将解压逻辑放到异步任务中，避免阻塞视图渲染主线程：

public async Task<IActionResult> ViewWordFile()
{
    string zipFile = Path.Combine(_hostEnv.WebRootPath, "files/zipped", "example03.zip");
    string unzipDir = Path.Combine(_hostEnv.WebRootPath, "files/unzip");
    
    await Task.Run(() => ZipFile.ExtractToDirectory(zipFile, unzipDir, true));

    return View();
}

3. 清理目标目录后再解压：覆盖文件可能存在缓存冲突，解压前先清空目标目录：

if (Directory.Exists(unzipDir))
{
    Directory.Delete(unzipDir, true);
}
Directory.CreateDirectory(unzipDir);
ZipFile.ExtractToDirectory(zipFile, unzipDir);

4. 修正iframe路径：确保视图中iframe指向解压后的文件路径/files/unzip/example03.htm，避免路径错误导致页面空白。
5. 启用详细日志：在appsettings.json中开启ASP.NET Core调试级日志，查看视图渲染过程中是否有未捕获的异常：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Debug"
    }
  }
}

6. 转移IO操作到后台：解压属于IO密集型操作，建议提前通过后台服务（如IHostedService）完成，避免在请求处理线程中执行，防止阻塞请求管道。

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