.NET Core MVC项目访问数据库相关页面出现报错

错误信息 #

Error.
An error occurred while processing your request.
Request ID: 00-9b679c467ad4ae70c778e88de56c8c7c-e143a80f82aa3911-00

Development Mode
Swapping to Development environment will display more detailed information about the error that occurred.

The Development environment shouldn't be enabled for deployed applications. It can result in displaying sensitive information from exceptions to end users. For local debugging, enable the Development environment by setting the ASPNETCORE_ENVIRONMENT environment variable to Development and restarting the app.

解决步骤 #

1. 获取详细错误信息 #

本地调试场景

• 通过环境变量开启开发环境：
  Windows命令行执行：set ASPNETCORE_ENVIRONMENT=Development
  Linux/macOS终端执行：export ASPNETCORE_ENVIRONMENT=Development
  执行后重启项目，即可看到具体的异常堆栈信息。
• 或者修改launchSettings.json文件，将ASPNETCORE_ENVIRONMENT的值改为Development，重新运行项目。

生产环境场景

禁止直接开启开发环境，避免泄露敏感信息，可通过以下方式排查：

• 查看项目日志：默认日志可在Windows事件查看器（应用程序日志）或项目根目录的logs文件夹中找到（若配置了文件日志）。
• 调整日志级别：在appsettings.json中增加EF Core相关的日志配置，捕获数据库交互细节：

  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Microsoft.EntityFrameworkCore": "Debug"
    }
  }
  

  重启应用后，日志会记录更详细的数据库操作错误，比如连接失败、查询异常等。

2. 常见数据库相关错误排查 #

• 连接字符串问题：检查appsettings.json中的ConnectionStrings节点，确认数据库服务器地址、库名、账号密码是否正确；若为云数据库，需确认服务器防火墙是否允许应用所在IP访问。
• 数据库迁移未执行：若项目刚部署，需执行EF Core迁移同步数据库结构。生产环境可通过命令dotnet ef database update执行（需提前安装EF Core工具），或生成SQL脚本手动在数据库中执行。
• 数据库权限不足：确认应用使用的数据库账号拥有目标数据库的读写权限，避免因权限不足导致操作失败。
• 模型与数据库结构不匹配：若实体类修改后未同步数据库（如新增字段、修改字段类型），会导致查询或写入时报错，需重新执行迁移或手动更新数据库结构。

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