首页 > Golang > Go教程

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

时间：2025-10-17 10:18:08 344浏览收藏

小伙伴们对Golang编程感兴趣吗？是否正在学习相关知识点？如果是，那么本文《Web服务器异常处理与日志记录示例》，就很适合你，本篇文章讲解的知识点主要包括。在之后的文章中也会多多分享相关知识点，希望对大家的知识积累有所帮助！

答案：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
});
});

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

主动抛出并结构化异常

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

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，推荐使用专业日志库如winston或pino：

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
});

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

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

以上就是《Web服务器异常处理与日志记录示例》的详细内容，更多关于的资料请关注golang学习网公众号！