错误代码: ${error.code}
错误信息: ${error.message}
发生时间: ${new Date().toLocaleString()}
请求路径: ${context.path}
用户ID: ${context.userId || '未知'}
IP地址: ${context.ip}
错误堆栈:\n${error.stack}
`
};
await transporter.sendMail(mailOptions);
}
```
#### 2. 钉钉/企业微信告警
```javascript
async function sendDingTalkAlert(error, context) {
const webhook = process.env.DINGTALK_WEBHOOK;
const message = {
msgtype: 'markdown',
markdown: {
title: '系统错误告警',
text: `
### 系统错误告警
- **错误代码**: ${error.code}
- **错误信息**: ${error.message}
- **发生时间**: ${new Date().toLocaleString()}
- **请求路径**: ${context.path}
- **用户ID**: ${context.userId || '未知'}
- **IP地址**: ${context.ip}
`
}
};
await fetch(webhook, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(message)
});
}
```
## 性能优化
### 日志性能优化
#### 1. 异步日志写入
```javascript
const winston = require('winston');
const logger = winston.createLogger({
transports: [
new winston.transports.File({
filename: 'logs/app.log',
// 启用异步写入
options: { flags: 'a' }
})
]
});
```
#### 2. 日志缓冲
```javascript
class LogBuffer {
constructor(flushInterval = 1000, maxBufferSize = 100) {
this.buffer = [];
this.flushInterval = flushInterval;
this.maxBufferSize = maxBufferSize;
// 定时刷新缓冲区
setInterval(() => this.flush(), flushInterval);
}
add(logEntry) {
this.buffer.push(logEntry);
// 缓冲区满时立即刷新
if (this.buffer.length >= this.maxBufferSize) {
this.flush();
}
}
flush() {
if (this.buffer.length === 0) return;
const logs = this.buffer.splice(0);
// 批量写入日志
this.writeLogs(logs);
}
writeLogs(logs) {
// 实现批量日志写入
}
}
```
#### 3. 日志采样
```javascript
class LogSampler {
constructor(sampleRate = 0.1) {
this.sampleRate = sampleRate;
}
shouldLog(level) {
// 错误日志始终记录
if (level === 'error') return true;
// 其他日志按采样率记录
return Math.random() < this.sampleRate;
}
}
```
### 错误处理性能优化
#### 1. 错误缓存
```javascript
const errorCache = new Map();
function cacheError(error, context) {
const key = `${error.code}_${context.path}`;
const cached = errorCache.get(key);
if (cached && Date.now() - cached.timestamp < 60000) {
// 1分钟内相同错误不重复处理
return false;
}
errorCache.set(key, {
timestamp: Date.now(),
count: (cached?.count || 0) + 1
});
return true;
}
```
#### 2. 错误聚合
```javascript
class ErrorAggregator {
constructor(windowSize = 60000) {
this.windowSize = windowSize;
this.errors = new Map();
// 定期清理过期错误
setInterval(() => this.cleanup(), windowSize);
}
add(error, context) {
const key = `${error.code}_${context.path}`;
const now = Date.now();
if (!this.errors.has(key)) {
this.errors.set(key, {
first: now,
last: now,
count: 1,
error,
context
});
} else {
const entry = this.errors.get(key);
entry.last = now;
entry.count++;
}
}
cleanup() {
const now = Date.now();
for (const [key, entry] of this.errors.entries()) {
if (now - entry.last > this.windowSize) {
this.errors.delete(key);
}
}
}
}
```
## 使用示例
### 基础错误处理
#### 1. 控制器中的错误处理
```javascript
const { AppError, ErrorTypes, catchAsync } = require('../middleware/errorHandler');
const logger = require('../utils/logger');
// 获取用户信息
const getUser = catchAsync(async (req, res, next) => {
const { userId } = req.params;
// 参数验证
if (!userId || !mongoose.Types.ObjectId.isValid(userId)) {
return next(new AppError(
ErrorTypes.INVALID_FORMAT.message,
400,
ErrorTypes.INVALID_FORMAT.code
));
}
// 查询用户
const user = await User.findById(userId);
if (!user) {
return next(new AppError(
ErrorTypes.RESOURCE_NOT_FOUND.message,
404,
ErrorTypes.RESOURCE_NOT_FOUND.code
));
}
// 权限检查
if (req.user.id !== userId && req.user.role !== 'admin') {
return next(new AppError(
ErrorTypes.PERMISSION_DENIED.message,
403,
ErrorTypes.PERMISSION_DENIED.code
));
}
// 记录业务日志
logger.business('查看用户信息', {
action: 'VIEW_USER',
targetUserId: userId,
operatorId: req.user.id,
ip: req.ip
});
res.json({
success: true,
data: { user }
});
});
```
#### 2. 数据库操作错误处理
```javascript
const { handleDatabaseError } = require('../middleware/errorHandler');
async function createUser(userData) {
try {
const user = new User(userData);
await user.save();
logger.business('用户创建成功', {
action: 'CREATE_USER',
userId: user._id,
email: user.email
});
return user;
} catch (error) {
// 处理数据库错误
throw handleDatabaseError(error);
}
}
```
### 高级日志记录
#### 1. 请求日志中间件使用
```javascript
const express = require('express');
const { requestLogger } = require('../utils/logger');
const app = express();
// 使用请求日志中间件
app.use(requestLogger);
// 路由定义
app.get('/api/users', (req, res) => {
// 业务逻辑
});
```
#### 2. 性能监控
```javascript
const logger = require('../utils/logger');
async function performDatabaseQuery(query) {
const startTime = Date.now();
try {
const result = await db.query(query);
const duration = Date.now() - startTime;
// 记录性能日志
logger.performance('数据库查询', {
query: query.sql,
duration,
rowCount: result.length,
success: true
});
// 慢查询告警
if (duration > 1000) {
logger.warn('慢查询检测', {
query: query.sql,
duration,
threshold: 1000
});
}
return result;
} catch (error) {
const duration = Date.now() - startTime;
logger.performance('数据库查询失败', {
query: query.sql,
duration,
error: error.message,
success: false
});
throw error;
}
}
```
#### 3. 安全事件记录
```javascript
const logger = require('../utils/logger');
// 登录失败记录
function recordLoginFailure(email, ip, reason) {
logger.security('登录失败', {
event: 'LOGIN_FAILED',
email,
ip,
reason,
timestamp: new Date(),
severity: 'medium'
});
}
// 可疑活动记录
function recordSuspiciousActivity(userId, activity, details) {
logger.security('可疑活动', {
event: 'SUSPICIOUS_ACTIVITY',
userId,
activity,
details,
timestamp: new Date(),
severity: 'high'
});
}
```
## 故障排除
### 常见问题
#### 1. 日志文件过大
**问题**: 日志文件增长过快，占用大量磁盘空间
**解决方案**:
- 启用日志轮转
- 调整日志级别
- 实施日志采样
- 定期清理旧日志
#### 2. 错误信息泄露
**问题**: 错误响应包含敏感信息
**解决方案**:
- 使用统一错误响应格式
- 过滤敏感信息
- 区分开发和生产环境
- 记录详细日志但返回简化错误
#### 3. 性能影响
**问题**: 日志记录影响系统性能
**解决方案**:
- 使用异步日志写入
- 实施日志缓冲
- 优化日志格式
- 使用日志采样
### 调试技巧
#### 1. 启用调试日志
```javascript
// 设置环境变量
NODE_ENV=development
LOG_LEVEL=debug
// 或在代码中动态设置
logger.level = 'debug';
```
#### 2. 错误追踪
```javascript
// 添加请求ID用于追踪
const { v4: uuidv4 } = require('uuid');
app.use((req, res, next) => {
req.requestId = uuidv4();
res.setHeader('X-Request-ID', req.requestId);
next();
});
// 在日志中包含请求ID
logger.info('处理请求', {
requestId: req.requestId,
method: req.method,
url: req.url
});
```
#### 3. 错误重现
```javascript
// 保存错误上下文用于重现
function saveErrorContext(error, req) {
const context = {
timestamp: new Date(),
error: {
message: error.message,
stack: error.stack,
code: error.code
},
request: {
method: req.method,
url: req.url,
headers: req.headers,
body: req.body,
params: req.params,
query: req.query
},
user: req.user,
session: req.session
};
// 保存到文件或数据库
fs.writeFileSync(
`error-contexts/${Date.now()}.json`,
JSON.stringify(context, null, 2)
);
}
```
## 最佳实践
### 错误处理最佳实践
1. **统一错误格式**: 使用统一的错误响应格式
2. **错误分类**: 明确区分业务错误和系统错误
3. **错误码管理**: 使用有意义的错误码
4. **安全考虑**: 不在错误响应中暴露敏感信息
5. **用户友好**: 提供用户友好的错误信息
### 日志记录最佳实践
1. **结构化日志**: 使用JSON格式记录结构化数据
2. **上下文信息**: 记录足够的上下文信息用于调试
3. **性能考虑**: 避免日志记录影响系统性能
4. **安全性**: 不在日志中记录敏感信息
5. **可搜索性**: 使用一致的字段名和格式
### 监控告警最佳实践
1. **合理阈值**: 设置合理的告警阈值
2. **告警分级**: 区分不同级别的告警
3. **避免告警疲劳**: 防止过多无用告警
4. **快速响应**: 建立快速响应机制
5. **持续优化**: 根据实际情况调整监控策略
## 总结
错误处理和日志系统是解班客平台稳定运行的重要保障。通过统一的错误处理机制、完善的日志记录功能和实时监控告警，系统能够快速发现和解决问题，提供稳定可靠的服务。
系统采用分层设计，支持多种错误类型和日志级别，提供了灵活的配置选项和丰富的功能特性。通过性能优化和最佳实践，确保系统在高负载情况下仍能正常运行。
未来将继续完善系统功能，增加更多监控指标和告警机制，为平台的稳定运行提供更强有力的支持。