ASP.NET Core Razor Pages特定路由在虚拟机开发环境返回404

以下是可能导致该问题的原因及对应的排查/解决方法：

1. 文件路径大小写不匹配 #

本地Windows系统对文件路径大小写不敏感，但如果虚拟机基于Linux/macOS系统，路径区分大小写。

• 排查点：确认虚拟机中项目的Razor页面路径是否为Pages/User/LoginUser.cshtml，注意User、LoginUser的大小写是否和路由完全一致（比如避免出现pages/user/loginuser.cshtml这类大小写不匹配的情况）。
• 解决方法：统一文件和文件夹的大小写，确保与路由/User/LoginUser完全对应。

2. 部署文件不完整 #

虚拟机上的项目部署包可能缺失了LoginUser.cshtml或其对应的代码后置文件（LoginUser.cshtml.cs）。

• 排查点：直接查看虚拟机中项目目录的Pages/User文件夹，确认相关文件是否存在。
• 解决方法：重新发布项目，确保所有Razor页面、依赖文件完整复制到虚拟机；检查发布配置的排除规则，避免误删必要文件。

3. 静态Web资产加载异常 #

当前代码仅在非开发环境调用StaticWebAssetsLoader.UseStaticWebAssets，但如果虚拟机中是通过发布包运行开发环境的项目，可能导致静态资产（包括Razor页面相关资源）加载失败。

• 解决方法：尝试在开发环境分支也添加静态Web资产加载代码，或者在虚拟机中使用dotnet run直接运行项目源码，而非发布包。

4. 应用URL绑定范围限制 #

launchSettings.json中applicationUrl设置为http://localhost:5212，这会限制应用仅绑定到虚拟机的本地回环地址，若通过虚拟机的外部IP访问会无法匹配路由。

• 排查点：确认在虚拟机中访问时使用的是http://localhost:5212/User/LoginUser，而非虚拟机的局域网IP。
• 解决方法：修改applicationUrl为http://0.0.0.0:5212，允许所有网络接口访问应用。

5. Razor页面路由指令缺失 #

若LoginUser.cshtml页面顶部未配置正确的路由指令，可能导致默认路由匹配失败。

• 排查点：检查LoginUser.cshtml的顶部是否有@page "/User/LoginUser"指令，若没有，Razor Pages会默认使用文件路径作为路由，此时需确保文件路径与路由完全匹配。

6. 环境变量配置不一致 #

虚拟机中的ASPNETCORE_ENVIRONMENT环境变量可能未正确设置为Development，导致触发不同的配置逻辑。

• 排查点：在虚拟机中执行命令检查环境变量：
  • Linux/macOS：echo $ASPNETCORE_ENVIRONMENT
  • Windows虚拟机：echo %ASPNETCORE_ENVIRONMENT%
• 解决方法：将虚拟机的ASPNETCORE_ENVIRONMENT设置为Development，与本地环境保持一致。

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