app.UseDeveloperExceptionPage了解

app.UseDeveloperExceptionPage() 是 ASP.NET Core 为开发环境量身定做的“黄页错误详情页”——
当代码抛出异常时，它会返回一个超详细的本地错误页面，帮你秒定位问题，绝对不要在生产环境开启！

---

✅ 一句话作用

“出现异常时，在浏览器里直接显示堆栈、局部变量、源代码高亮、请求头、路由、QueryString 等全部调试信息，方便开发者现场排错。”

---

📸 页面长什么样

• 黄色标题栏（俗称“黄页”）
• 异常消息 + 完整堆栈
• 出错的源代码片段 + 行号高亮
• 局部变量值、参数值
• 请求方法、路径、Query、Header、Cookie
• 路由终结点、中间件管道快照

---

🔧 用法（仅限开发）

csharp

复制

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();   // ← 开发时开
}
else
{
    app.UseExceptionHandler("/Error"); // 生产用友好页
}

 

---

🚫 生产环境后果

• 把堆栈、源码、路径暴露给用户 → 信息泄露、安全风险
• 体验极差（黄页对用户毫无意义）

---

🧪 与 Swagger / Mini-API 调试结合

csharp

复制

if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
    app.UseSwagger();
    app.UseSwaggerUI();
}

 

---

📝 小结一句话

app.UseDeveloperExceptionPage() 就是：
“开发阶段专用的‘黄页’超级错误详情页，抛出异常时立刻在浏览器里显示源码、堆栈、变量，助你秒修 Bug，生产环境务必关闭。”