用户反馈收集：界面设计与日志记录最佳实践

json { "timestamp": "2025-03-15T08:22:11Z", "rating": 2, "category": "bug", "comment": "点击保存后页面无反应", "context": { "url": "/create-order", "user_id": "u_8972", "session_id": "sess_ab12", "browser": "Chrome 120", "screen_size": "1440x900", "last_actions": ["focus #save-btn", "click #save-btn"], "meta": { "app_version": "3.2.1", "feature_flag": "new_checkout" } }, "screenshot_base64": "(optional, length limited)" }

该结构确保反馈不仅是文本，更是可诊断的事件快照。

---

## 反馈日志记录：构建可分析的可靠管道

### 1. 服务端日志架构：双通道策略

为应对高并发与数据完整性要求，推荐采用**异步写入 + 事务性存储**混合模式：

- **高速通道**：反馈先写入消息队列（如Kafka、RabbitMQ），由消费者批量写入时序数据库（如ClickHouse）或日志文件，用于实时监控与查询。
- **确保持久化**：同时将原始反馈记录写入关系型数据库的`feedback_log`表，以备精确回溯和关联用户画像。

### 2. 结构化日志规范：让每一条反馈可检索

避免记录无结构的纯文本“抱怨信息”，采用以下**标准字段集**：

| 字段 | 类型 | 说明 | 必填 |
|------|------|------|------|
| `event_id` | UUID | 全局唯一标识，用于去重和链式追踪 | 是 |
| `event_type` | string | 固定为`feedback_received` | 是 |
| `source` | string | 来源入口，如`widget_sidebar`、`email_link` | 是 |
| `user_id` | string/null | 登录用户唯一ID，未登录可空但需携带`anonymous_id` | 否 |
| `anonymous_id` | string | 设备指纹或session标识，用于未登录场景 | 否 |
| `rating` | int | 1-5分或表情映射数值 | 否 |
| `category` | string | 从预定义列表中选择，如`bug`、`feature_request` | 否 |
| `body` | text | 用户自由描述的文本 | 否 |
| `context` | json | 前端传递的完整上下文对象 | 是 |
| `client_ts` | timestamp | 客户端时间戳 | 是 |
| `server_ts` | timestamp | 服务端接收时戳 | 是 |

### 3. 日志记录最佳实现模式

#### Node.js 示例（使用结构化日志库）

```javascript
// 使用 pino 或 winston 输出结构化日志
const logger = require('pino')();

app.post('/api/feedback', async (req, res) => {
  const feedback = req.body;
  const serverTs = new Date().toISOString();
  
  // 1. 写入消息队列（伪代码）
  await feedbackQueue.send({
    ...feedback,
    event_id: generateUUID(),
    server_ts: serverTs,
  });

  // 2. 记录结构化日志用于后续分析
  logger.info({
    event_id: feedback.event_id || generateUUID(),
    event_type: 'feedback_received',
    source: feedback.source,
    user_id: feedback.context?.user_id,
    category: feedback.category,
    rating: feedback.rating,
    url: feedback.context?.url,
    message_preview: feedback.comment?.slice(0, 100),
    client_ts: feedback.timestamp,
    server_ts: serverTs,
  });

  res.status(202).send({ status: 'received' });
});