SuperAPI AI 工具集

sentry-tanstack-start-sdk

前端与建站

查看项目

更新于 10-15 21:51

技能介绍

用途:为 TanStack Start React 应用提供完整 Sentry SDK 安装与配置指导,覆盖浏览器和服务器运行时。触发场景包括添加 Sentry、安装或配置 @sentry/tanstackstart-react,以及启用错误监控、追踪、会话回放、日志或用户反馈。

主要能力:先扫描项目判断是否已用 @tanstack/react-start、是否已装 Sentry、是否存在 src/router.tsx、src/start.ts、src/server.ts、instrument.server.mjs、vite.config.ts 以及 SENTRY_AUTH_TOKEN 等,再给出推荐并分步引导配置。核心推荐为错误监控、追踪、会话回放;日志与用户反馈按需启用。

使用方式:安装命令 npm install @sentry/tanstackstart-react --save。客户端在 src/router.tsx 的 router 工厂内、且 !router.isServer 时调用 Sentry.init,并加入 tanstackRouterBrowserTracingIntegration(router)、replayIntegration()、feedbackIntegration()。服务端在根目录 instrument.server.mjs 中 Sentry.init。Vite 配置中 sentryTanstackStart 必须为最后一个插件,配合 org、project 与 process.env.SENTRY_AUTH_TOKEN。src/server.ts 用 wrapFetchWithSentry 包裹 fetch 处理器;src/start.ts 注册 sentryGlobalRequestMiddleware 与 sentryGlobalFunctionMiddleware,二者需位于各自数组首位。运行时启动可选 --import 标志(生产优先)或在 src/server.ts 顶部直接 import,后者仅支持原生 Node 插桩。

适用场景:需为 TanStack Start React 应用接入错误监控、路由与请求性能追踪、会话回放、结构化日志和站内用户反馈的团队。

限制:该 SDK 目前为 alpha,实施前需对照官方文档核对。未提供具体收费与价格信息。直接 import 方式无法捕获库级 span;SSR 渲染异常不会被自动捕获,需在错误边界手动 Sentry.captureException。配置 dataCollection 时注意:传入对象(即使为空)会把未设置类别转为宽松默认值;省略时回退到 sendDefaultPii(默认 false)。