ASP.NET Core MVC 无法通过file协议访问共享文件夹PDF附件的解决方法

该方案失效的核心原因不是ASP.NET Core框架限制，而是现代浏览器的通用安全策略：所有运行在http/https协议下的网页，出于跨域安全防护规则，完全不允许通过前端代码调用file://协议访问服务器、其他终端的本地或共享文件夹路径。无论后端使用什么框架，你编写的这类<a href="file:///C:">链接都会被浏览器直接拦截，没有正常生效的可能。

方案1：后端文件流代理（最推荐，完美匹配你的PDF附件场景） #

这是ASP.NET Core下处理服务器/共享文件夹附件的标准实现，完全绕过浏览器安全限制，还能附带完善的权限控制能力：

• 提前配置服务器端最小权限：给运行ASP.NET Core的进程身份（比如IIS应用池身份、Kestrel进程的运行用户）授予共享文件夹的只读权限，关闭写权限以规避安全风险。注意如果使用UNC路径（比如\\fileserver\order-share），不要依赖系统的盘符映射——系统级的盘符映射对服务运行身份是不生效的，直接在配置中写入完整UNC路径即可。
• 服务端维护路径映射关系：在数据库中记录每个附件的附件ID、所属订单ID、对应真实共享路径，绝对不要把真实物理路径暴露到前端代码中，从根源避免路径穿越风险。
• 编写专用的附件访问Action，直接返回物理文件流：

  public async Task<IActionResult> ViewOrderAttachment(int attachmentId)
  {
      // 根据附件ID从数据库查询对应的文件记录
      var attachment = await _db.OrderAttachments.FindAsync(attachmentId);
      if (attachment == null) return NotFound();
  
      // 必做：校验当前登录用户是否有权查看该订单的附件，不要跳过权限校验环节
      var userAccess = await _orderPermissionService.CheckAccess(User, attachment.OrderId);
      if (!userAccess) return Forbid();
  
      // 直接返回PDF文件流，开启范围请求支持，适配浏览器内置PDF预览能力
      return PhysicalFile(
          physicalPath: attachment.SharedFilePath, 
          contentType: "application/pdf",
          enableRangeProcessing: true
      );
  }
  

• 前端附件列表直接绑定该Action的路由即可，无需使用任何file://协议：

  <!-- 每个附件对应一个独立链接，新标签页打开可直接内嵌预览PDF -->
  @foreach (var attachment in Model.OrderAttachments)
  {
      <a href="@Url.Action("ViewOrderAttachment", "Order", new { attachmentId = attachment.Id })" 
         target="_blank">
          @attachment.FileName
      </a>
  }
  

这个方案完全适配你当前每个订单对应6个以上PDF附件的场景：

• 浏览器会内置打开PDF预览，不需要用户手动下载到本地才能查看
• 可以灵活配置访问权限，不会泄露服务器的共享目录结构
• 后续如果要把附件从共享文件夹迁移到对象存储，只需要修改后端读文件的逻辑，前端代码完全不需要调整

方案2：直接开放共享文件夹访问（仅适合极特殊内网场景，不推荐） #

如果系统是纯内网部署，所有用户终端都在同一个内网域内，可以让前端拼接UNC共享路径的file://链接，但该方案存在非常多硬限制：

• 目前所有基于Chromium内核的现代浏览器，默认都会拦截http网页发起的file://请求，用户点击链接大概率没有任何响应
• 没有内置权限校验机制，任何拿到路径的人都可以直接访问文件，存在数据泄露风险
• 公网用户完全无法访问内网共享路径，场景适配性极差

• 绝对不要让前端直接把文件路径传到后端，否则很容易被恶意构造路径触发穿越攻击（比如传入../web.config读取应用敏感配置），所有物理路径映射必须存在服务端，前端只传递无业务风险的附件ID
• 使用PhysicalFile方法时一定要开启enableRangeProcessing参数，否则大体积PDF在浏览器中会加载失败，无法正常翻页预览
• 遵循最小权限原则，不要给服务运行身份分配共享文件夹的写权限

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