小程序监控告警与错误上报

// app.js 全局错误兜底
App({
  onLaunch() {
    // 捕获页面未处理异常
    wx.onError((error) => {
      reportError({
        type: 'js_error',
        message: error.message,
        stack: error.stack,
        page: currentPageRoute()
      });
    });

    // 捕获小程序运行时的全局错误
    wx.onUnhandledRejection((res) => {
      reportError({
        type: 'unhandled_rejection',
        message: String(res.reason)
      });
    });
  }
});

function currentPageRoute() {
  const pages = getCurrentPages();
  const current = pages[pages.length - 1];
  return current ? current.route : 'unknown';
}

// utils/guard.js：统一 try-catch 包装异步逻辑
function safe(fn, context) {
  return async function (...args) {
    try {
      return await fn.apply(this, args);
    } catch (err) {
      reportError({
        type: 'async_error',
        name: err.name,
        message: err.message,
        stack: err.stack,
        context: context || 'unknown'
      });
      throw err;
    }
  };
}

// 使用示例：包住页面方法
Page({
  onLoad: safe(function () {
    // 页面初始化逻辑
  }, 'home_onload')
});

// 统一请求封装中的错误上报
function request(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      ...options,
      success(res) {
        if (res.statusCode >= 500) {
          reportError({
            type: 'http_5xx',
            url: options.url,
            statusCode: res.statusCode,
            costMs: res.costMs
          });
        } else if (res.data && res.data.code !== 0) {
          reportError({
            type: 'biz_error',
            url: options.url,
            bizCode: res.data.code
          });
        }
        resolve(res.data);
      },
      fail(err) {
        reportError({
          type: 'network_fail',
          url: options.url,
          errMsg: err.errMsg
        });
        reject(err);
      }
    });
  });
}

// utils/reporter.js：批量上报 + 本地缓冲
class Reporter {
  constructor() {
    this.queue = [];
    this.maxBatch = 20;
    this.flushInterval = 3000;   // 3 秒批量发送一次
    this.start();
  }

  push(payload) {
    // 限流：单用户单日最多上报 200 条
    const key = `report_count_${today()}`;
    const count = wx.getStorageSync(key) || 0;
    if (count >= 200) return;
    wx.setStorageSync(key, count + 1);

    // 脱敏：去掉 openid、手机号等敏感字段
    payload.openid = mask(payload.openid);
    this.queue.push(payload);
    if (this.queue.length >= this.maxBatch) {
      this.flush();
    }
  }

  flush() {
    if (this.queue.length === 0) return;
    const batch = this.queue.splice(0);
    wx.request({
      url: 'https://monitor.example.com/report',
      method: 'POST',
      data: { logs: batch },
      fail() {
        // 失败时写回本地，下次补发
        wx.setStorageSync('pending_logs', batch);
      }
    });
  }
}

// utils/perf.js：启动耗时采集
function reportLaunchPerformance() {
  const perf = wx.getPerformance();
  const nav = perf.getEntriesByType('navigation')[0];
  if (!nav) return;

  reportMetric('launch', {
    appLaunch: nav.appLaunch,          // 小程序启动到 onLaunch
    pageRender: nav.pageRender,        // 页面首次渲染
    jsBundle: nav.jsBundle,            // 代码注入
    network: nav.network,              // 首屏网络
    ttfb: nav.ttfb
  });
}

// 性能数据上报结构
{
  "metric": "launch",
  "page": "pages/index/index",
  "values": {
    "appLaunch": 320,
    "pageRender": 780,
    "jsBundle": 210
  },
  "device": {
    "model": "iPhone 15",
    "system": "iOS 18.0",
    "wechat": "8.0.50"
  },
  "networkType": "wifi"
}

去重维度：错误指纹（message + stack 前几帧 + 页面）
收敛策略：同一指纹进入静默窗口（如 5 分钟），窗口内只发一次
升级策略：静默窗口内重复次数超过 N 次，自动升级 P 级

// 告警判定伪代码
function shouldAlert(metric, currentValue, baseline, ratio = 2) {
  if (baseline <= 0) return false;
  return currentValue > baseline * ratio;
}

告警触发（发现）
    ↓ 聚合堆栈与上下文（定位）
    ↓ 修复并灰度发布（修复）
    ↓ 观察告警是否消失（验证）
    ↓ 补测试与回归用例（预防）

{
  "appVersion": "1.2.1",
  "buildNo": "20260930-001",
  "commitSha": "a3f2c9e",
  "grayGroup": "experiment"
}