0

0

Web服务器异常处理与日志记录示例

P粉602998670

P粉602998670

发布时间:2025-10-12 22:35:01

|

447人浏览过

|

来源于php中文网

原创

答案:Web服务器应通过统一异常处理中间件捕获各类错误,使用结构化错误对象(如AppError)携带状态码和消息,结合专业日志库(如winston)记录详细信息,并区分环境返回客户端友好提示,确保系统稳定与可维护性。

web服务器异常处理与日志记录示例

当Web服务器遇到异常时,良好的错误处理和日志记录机制能帮助开发者快速定位问题、提升系统稳定性。以下是一个实用的异常处理与日志记录示例,适用于常见的Web应用环境(如Node.js + Express)。

异常类型与常见场景

Web服务器可能遇到多种异常:

  • 客户端错误:如400(请求格式错误)、404(资源不存在)
  • 服务器错误:如500(内部错误)、502(网关错误)
  • 代码异常:未捕获的JavaScript错误、数据库连接失败等
  • 超时或网络中断:第三方API调用超时、客户端断开连接

针对这些情况,需在中间件中统一拦截并处理。

统一异常处理中间件

在Express中,可通过错误处理中间件捕获异步和同步异常:

app.use((err, req, res, next) => {
  // 默认状态码
  const statusCode = err.statusCode || 500;

// 记录错误日志 console.error(${new Date().toISOString()} - ${req.method} ${req.url}); console.error(状态码: ${statusCode}); console.error(错误信息: ${err.message}); console.error(堆栈: ${err.stack});

// 返回客户端友好的响应 res.status(statusCode).json({ success: false, message: statusCode === 500 ? '服务器内部错误' : err.message }); });

这个中间件应放在所有路由之后注册,确保能捕获后续中间件抛出的错误。

主动抛出并结构化异常

避免直接抛出字符串错误,建议封装错误对象:

Spirit Me
Spirit Me

SpiritMe允许用户使用数字化身制作视频,这些化身可以模拟用户的声音和情感

下载
class AppError extends Error {
  constructor(message, statusCode) {
    super(message);
    this.statusCode = statusCode;
    Error.captureStackTrace(this, this.constructor);
  }
}

// 在业务逻辑中使用 if (!user) { throw new AppError('用户不存在', 404); }

这样能保证错误携带状态码和可读信息,便于日志记录和响应生成。

日志记录最佳实践

生产环境中不应仅依赖console.error,推荐使用专业日志库如winstonpino

const winston = require('winston');

const logger = winston.createLogger({ level: 'info', format: winston.format.json(), transports: [ new winston.transports.File({ filename: 'logs/error.log', level: 'error' }), new winston.transports.File({ filename: 'logs/combined.log' }) ] });

// 在异常处理中使用 logger.error({ timestamp: new Date().toISOString(), method: req.method, url: req.url, statusCode: err.statusCode || 500, message: err.message, stack: err.stack });

结构化日志有助于后期检索与分析,尤其在分布式系统中至关重要。

基本上就这些。关键在于统一处理入口、结构化错误对象、持久化记录日志,并区分开发与生产环境的反馈信息。不复杂但容易忽略细节。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
什么是分布式
什么是分布式

分布式是一种计算和数据处理的方式,将计算任务或数据分散到多个计算机或节点中进行处理。本专题为大家提供分布式相关的文章、下载、课程内容,供大家免费下载体验。

330

2023.08.11

分布式和微服务的区别
分布式和微服务的区别

分布式和微服务的区别在定义和概念、设计思想、粒度和复杂性、服务边界和自治性、技术栈和部署方式等。本专题为大家提供分布式和微服务相关的文章、下载、课程内容,供大家免费下载体验。

235

2023.10.07

什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

178

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

216

2025.12.18

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

228

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

297

2023.10.25

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

299

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

212

2023.09.04

java入门学习合集
java入门学习合集

本专题整合了java入门学习指南、初学者项目实战、入门到精通等等内容,阅读专题下面的文章了解更多详细学习方法。

1

2026.01.29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 4.3万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 2.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号