Node.js中用Jest与sentry-testkit做单元测试时遇'sentry'未定义错误

开发者阿泽

2026-7-24

解决Jest + sentry-testkit测试时的TypeError问题

错误原因分析

出现TypeError: Cannot read properties of undefined (reading 'sentry')通常是因为sentry-testkit与@Sentry/node版本不兼容，或者Sentry初始化、测试逻辑存在疏漏。

修复步骤

1. 确保依赖版本兼容

首先检查package.json中的依赖版本：

若使用@sentry/node v7.x及以上版本，需将sentry-testkit升级至v5.x及以上的稳定版
执行命令更新依赖：

npm install sentry-testkit@latest @sentry/node@latest --save-dev

2. 修正测试代码逻辑

你的测试代码存在两个核心问题：未实际触发错误供Sentry捕获，初始化逻辑未贴合测试场景。修改后的代码如下：

import { describe, expect, it, beforeAll, afterEach } from '@jest/globals';
import * as Sentry from '@sentry/node';
import sentryTestKit from 'sentry-testkit';

const { testkit, sentryTransport } = sentryTestKit();

// 测试前统一初始化Sentry
beforeAll(() => {
  Sentry.init({
    dsn: 'fake-dsn', // 测试环境无需真实DSN
    transport: sentryTransport,
    enabled: true,
  });
});

// 每个测试用例后重置testkit，避免数据污染
afterEach(() => {
  testkit.reset();
});

describe('Sentry Test', () => {
  describe('Error Capture', () => {
    it('should catch thrown errors', () => {
      // 主动触发一个错误，让Sentry捕获
      const testError = new Error('Test Sentry Error');
      Sentry.captureException(testError);

      // 验证捕获到的错误数量
      expect(testkit.reports()).toHaveLength(1);
      // 可选：验证错误内容是否匹配
      expect(testkit.reports()[0].exception.values[0].value).toBe('Test Sentry Error');
    });
  });
});