.NET 4.7项目IIS Express虚拟文件夹404错误求助

我有一个基于.NET 4.7的VB.NET/ASP.NET Web应用，尝试通过VirtualPathProvider实现虚拟文件夹，将~/Repository映射到物理路径C:\Temp\Repository。访问~/Repository时，自定义RepositoryPathProvider类的FileExists、DirectoryExists和GetFile方法均被触发，但网页中虚拟文件夹内的图片、CSS等资源报404未找到错误。

相关代码 #

Global.asax.vb #

If Not settings.BMSRepositoryPath Is Nothing Then
    Dim rpp As New RepositoryPathProvider("~/Repository", settings.BMSRepositoryPath)
    HostingEnvironment.RegisterVirtualPathProvider(rpp)
End If

RepositoryPathProvider.vb #

Public Class RepositoryPathProvider : Inherits VirtualPathProvider

    Private ReadOnly _virtualDir As String 'Virtual folder path, i.e. ~/VirtualFolder
    Private ReadOnly _physicalPath As String 'Physical folder path, i.e. C:\PhysicalPath\MyFolder

    Public Sub New(virtualDir As String, physicalPath As String)
        MyBase.New()
        _virtualDir = virtualDir
        _physicalPath = physicalPath
    End Sub

    Public Overrides Function FileExists(virtualPath As String) As Boolean
        If IsVirtualFolderPath(virtualPath) Then
            Dim physicalPath As String = MapVirtualToPhysicalPath(virtualPath)
            Return System.IO.File.Exists(physicalPath)
        End If
        Dim retval = Previous.FileExists(virtualPath)
        Return retval
    End Function

    Public Overrides Function DirectoryExists(virtualPath As String) As Boolean
        If IsVirtualFolderPath(virtualPath) Then
            Dim physicalPath As String = MapVirtualToPhysicalPath(virtualPath)
            Return System.IO.Directory.Exists(physicalPath)
        End If
        Return Previous.DirectoryExists(virtualPath)
    End Function

    Public Overrides Function GetFile(virtualPath As String) As VirtualFile
        If IsVirtualFolderPath(virtualPath) Then
            Dim physicalPath As String = MapVirtualToPhysicalPath(virtualPath)
            Dim retval = New CustomVirtualFile(virtualPath, physicalPath)
            Return retval
        End If
        Return Previous.GetFile(virtualPath)
    End Function

    Public Overrides Function GetDirectory(virtualPath As String) As VirtualDirectory
        If IsVirtualFolderPath(virtualPath) Then
            Dim physicalPath As String = MapVirtualToPhysicalPath(virtualPath)
            Return New CustomVirtualDirectory(virtualPath, physicalPath)
        End If
        Return Previous.GetDirectory(virtualPath)
    End Function

    Private Function IsVirtualFolderPath(virtualPath As String) As Boolean
        Dim appRelativePath As String = VirtualPathUtility.ToAppRelative(virtualPath)
        Return appRelativePath.StartsWith(_virtualDir, StringComparison.OrdinalIgnoreCase)
    End Function

    Private Function MapVirtualToPhysicalPath(virtualPath As String) As String
        Dim appRelativePath As String = VirtualPathUtility.ToAppRelative(virtualPath)
        Dim relativePath As String = appRelativePath.Substring(_virtualDir.Length).Replace("/", "\")

        If relativePath.StartsWith("\") Then relativePath = relativePath.Substring(1)

        Dim retval As String = System.IO.Path.Combine(_physicalPath, relativePath)

        Return retval
    End Function
End Class

CustomVirtualFile.vb #

Public Class CustomVirtualFile
    Inherits VirtualFile

    Private ReadOnly _physicalPath As String

    Public Sub New(virtualPath As String, physicalPath As String)
        MyBase.New(virtualPath)
        _physicalPath = physicalPath
    End Sub

    Public Overrides Function Open() As System.IO.Stream
        Return System.IO.File.OpenRead(_physicalPath)
    End Function
End Class

CustomVirtualDirectory.vb #

Public Class CustomVirtualDirectory
    Inherits VirtualDirectory

    Private ReadOnly _physicalPath As String

    Public Sub New(virtualPath As String, physicalPath As String)
        MyBase.New(virtualPath)
        _physicalPath = physicalPath
    End Sub

    Public Overrides ReadOnly Property Children() As System.Collections.IEnumerable
        Get
            Return New List(Of Object)()
        End Get
    End Property

    Public Overrides ReadOnly Property Files() As System.Collections.IEnumerable
        Get
            Dim m_files As New List(Of VirtualFile)()
            If System.IO.Directory.Exists(_physicalPath) Then
                For Each filePath As String In System.IO.Directory.GetFiles(_physicalPath)
                    Dim fileName As String = System.IO.Path.GetFileName(filePath)
                    Dim virtualPath As String = VirtualPathUtility.Combine(virtualPath, fileName)
                    m_files.Add(New CustomVirtualFile(virtualPath, filePath))
                Next
            End If
            Return m_files
        End Get
    End Property


    Public Overrides ReadOnly Property Directories() As System.Collections.IEnumerable
        Get
            Return New List(Of VirtualDirectory)()
        End Get
    End Property
End Class

问题排查与解决方案 #

1. 静态资源处理限制 #

ASP.NET默认让IIS直接处理静态资源（图片、CSS、JS等），不会经过VirtualPathProvider管道。这是404错误的核心原因：请求直接到IIS，而IIS找不到虚拟路径对应的物理文件。

解决方法：
在Web.config中添加配置，让虚拟文件夹下的静态资源请求通过ASP.NET管道处理：

<system.webServer>
  <handlers>
    <add name="RepositoryStaticFiles" path="~/Repository/*" verb="GET" type="System.Web.StaticFileHandler" preCondition="integratedMode" />
  </handlers>
</system.webServer>

2. 虚拟路径匹配优化 #

原IsVirtualFolderPath方法可能误匹配类似~/RepositoryTest的路径，需优化判断逻辑，确保仅匹配虚拟目录及其子路径：

Private Function IsVirtualFolderPath(virtualPath As String) As Boolean
    Dim appRelativePath As String = VirtualPathUtility.ToAppRelative(virtualPath).TrimEnd("/"c)
    Dim virtualDirTrimmed = _virtualDir.TrimEnd("/"c)
    ' 匹配虚拟目录本身或其子路径
    Return appRelativePath.Equals(virtualDirTrimmed, StringComparison.OrdinalIgnoreCase) _
           OrElse appRelativePath.StartsWith(virtualDirTrimmed & "/", StringComparison.OrdinalIgnoreCase)
End Function

3. 权限检查 #

确保应用程序池身份（默认是ApplicationPoolIdentity）对C:\Temp\Repository有读取权限。权限不足会导致即使路径正确，也返回404或权限错误。

4. 更优实现方案：IIS虚拟目录 #

如果不需要动态逻辑，直接在IIS中创建虚拟目录是更简单高效的选择：

• 打开IIS管理器，找到目标Web应用
• 右键选择「添加虚拟目录」
• 别名设为Repository，物理路径指向C:\Temp\Repository
• 配置好对应权限即可

这种方式无需编写代码，性能更优，适合静态资源映射场景。

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