ASP.NET Core发布后wwwroot静态HTML引用bundle.js加载失败求助

静态HTML文件中的~路径占位符是ASP.NET Core Razor 视图/页面专属的语法，只有被Razor引擎处理的文件（.cshtml后缀）才会自动将~解析为站点根路径，直接放在wwwroot下的静态.html文件不会被服务器端Razor引擎处理，因此~会原样输出到浏览器，被编码为%7E后拼接在请求路径中，导致资源加载失败。

• 优先修改静态index.html中的资源引用路径：
  • 如果站点部署在域名根目录，直接将src="~/scripts/bundle.js"改为src="/scripts/bundle.js"，浏览器会直接从站点根路径请求资源
  • 如果站点部署在子应用目录，或者要兼容不同部署路径，改为相对路径src="scripts/bundle.js"，会基于当前index.html的所在路径加载资源
• 排查本地运行正常的差异点：
  • 检查本地开发环境是否引入了WebOptimizer等静态资源处理中间件，这类中间件会额外解析静态HTML中的~占位符，发布时可能没有同步启用对应配置
  • 确认本地是否是通过Razor布局/页面渲染的HTML内容，而非直接访问wwwroot下的静态index.html，发布时才生成静态文件输出到wwwroot
  • 检查项目的Debug/Release配置差异，是否Debug模式下开启了特殊静态文件处理逻辑，Release发布时被禁用
• 额外排查项：
  • 确认Program.cs/Startup.cs中UseStaticFiles中间件的配置，没有配置自定义RequestPath前缀，如果配置了需要在资源路径前加上对应前缀
  • 检查发布后的wwwroot目录，确认scripts/bundle.js文件确实存在，没有被csproj的资源排除规则过滤掉
  • 如果使用了Vite、Webpack等前端打包工具，检查打包配置的publicPath是否正确，错误的publicPath也会生成错误的资源引用路径

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