ASP.NET Core 2.2 迁移项目目录后IIS Express静态资源404问题求助

问题背景 #

• 已开发一年以上的ASP.NET Core 2.2项目，此前运行完全正常；将项目工作目录从用户配置文件夹迁移至C盘后出现异常
• 项目可成功编译生成，但在Visual Studio 2017中通过IIS Express启动时，浏览器返回Failed to load resource: the server responded with a status of 404 (Not Found)错误，wwwroot目录下所有JS、CSS、图片资源均加载失败，静态资源路径无法正常解析
• 新建同类型ASP.NET Core 2.2项目测试，复现完全相同的问题
• 对照同配置同事设备的运行状态、全量项目配置文件，所有内容保持一致，同事侧项目运行无异常
• 当前运行环境：.NET Core SDK 2.2.110、Visual Studio 2017

已尝试的无效排查操作 #

以下排查动作均未解决核心问题：

• 检查项目.vs目录下的applicationhost.config文件
• 核对appsettings系列配置文件
• 检查项目根目录web.config配置
• 核对launchSettings启动配置
• 手动在Startup类Configure方法中显式配置静态文件中间件：app.UseStaticFiles(new StaticFileOptions { FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), "wwwroot")), RequestPath = "/wwwroot" });
• 修改Program类的WebHost创建逻辑，手动添加Web根目录配置：WebHost.CreateDefaultBuilder(args).UseWebRoot(Path.Combine(AppContext.BaseDirectory, "wwwroot"))
• 逐行核对IIS Express的applicationhost.config站点配置，确认虚拟目录物理路径、HTTP/HTTPS绑定均正确
• 尝试其他公开渠道提及的同类问题解决方案，问题依旧存在

注：社区提出的移除资源路径中~/前缀的方案不适用——因项目为团队公共协作代码库，该修改会影响其他成员的正常运行环境，无法落地采用

定向排查方向 #

按操作优先级依次验证定位问题：

• 排查目录权限问题：项目从用户目录迁移至C盘后，若放置在C盘根目录、系统受保护路径下，IIS Express的运行身份可能丢失对项目目录的读取权限。右键项目根目录→属性→安全，确认当前登录用户对目录及wwwroot子目录拥有读取和执行、列出文件夹内容、读取的基础权限；临时将项目移动到无特殊权限管控的路径（如C:\Projects\xxx）测试，排除系统权限拦截。
• 清理残留IIS Express站点配置：关闭所有Visual Studio实例，删除项目根目录下的.vs隐藏文件夹；打开用户目录下的IIS Express全局配置路径%USERPROFILE%\Documents\IISExpress\config\applicationhost.config，删除旧路径对应的残留站点注册信息，重新打开项目触发新的配置生成，避免旧物理路径映射残留。
• 校验MIME类型映射：IIS Express依赖系统注册的MIME类型返回静态资源，若注册表被第三方软件篡改，会导致所有静态资源被拦截。打开IIS Express管理器，选中对应站点的MIME类型配置，确认.js、.css、.png、.jpg等常见静态资源类型的映射规则正常；临时关闭本地安全软件、Web代理工具，排除拦截类问题。
• 核对运行时工作目录：在Startup类Configure方法开头，打印Directory.GetCurrentDirectory()的实际输出值，对比项目实际根目录路径，确认运行时工作目录没有被错误指向旧的项目路径；避免将项目放在包含中文、空格、特殊字符的路径下，.NET Core 2.2版本对这类特殊路径的兼容存在已知缺陷。

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