主包体积优化
主包接近平台上限时,先检查 SDK 在最终小程序中的实际增量与重复副本,再决定是否延迟加载。sentry-miniapp 包含 @sentry/core 与多端适配,实际占用随版本、格式和打包方式变化;gzip 大小不能代替平台包体积。
先确认实际占用
- npm 展示的解包总量包含 ESM/CommonJS/UMD、类型声明和 Source Map,不代表小程序需要打入的体积;项目只应使用所需的构建格式。
- 用平台开发者工具或框架构建分析查看最终 JS 属于主包还是分包,并检查是否出现 SDK 或 Core 的重复副本。
- 关闭性能、日志等可选采集会改变运行行为,不保证对应代码从产物中移除。ESM 的按需裁剪取决于打包器和实际引用;独立 CommonJS/UMD 文件包含完整 SDK。
框架项目先检查 ESM 按需打包
Taro、uni-app 等构建项目,先确认打包器实际使用 ESM 入口,再查看最终包分析。明确引用使用的 API;需要宿主性能条目时才添加 performanceIntegration()。没有使用的 Performance API、HTTP 上下文集成可以被支持 tree-shaking 的打包器移除,已有的默认集成和跨端回退仍会保留。
import { init, performanceIntegration } from 'sentry-miniapp';
init({
dsn: 'YOUR_DSN',
integrations: [performanceIntegration()], // 需要宿主性能条目时添加
});不需要该能力时移除这项导入和配置。避免通过动态属性名读取整个 SDK 或集成命名空间,这可能让打包器保留所有出口。不同工具链的结果可能不同,仍须以最终小程序产物为准;这项裁剪不会让独立 CommonJS 文件变成按需版本。
方案 A:微信原生分包异步化
微信原生支持分包异步化,可用 require.async 跨分包加载 SDK。
- 把
sentry-miniapp的 npm 包或构建产物放进某个分包目录(如subpackageA)。 - 在
app.js中用require.async异步加载并初始化:
// app.js
App({
onLaunch() {
require.async('./subpackageA/sentry-miniapp.js')
.then((Sentry) => {
Sentry.init({ dsn: 'YOUR_DSN' /* ...其他配置 */ });
})
.catch((err) => console.error('Sentry 加载失败', err));
},
});确认生成的 SDK 文件被归入 subpackageA 后,它的体积会计入分包,主包不再同步加载 SDK。用开发者工具的包体积分析核对结果,避免打包器仍在主包保留副本。
方案 B:其他平台 / 跨端框架
支付宝、字节、百度、Taro、uni-app 等项目要以各自平台和框架的分包能力为准。通用原则是:确保 SDK 的实际产物被打进分包,并在分包加载完成后再执行 Sentry.init。不同工具链对 import('sentry-miniapp') 是否拆包、拆到哪个包,规则并不一致,不能只看源码写法。
建议每次调整后检查构建产物:
- 主包目录里不应出现
sentry-miniapp/@sentry/core相关大块代码; - 分包目录里能找到 SDK 产物或对应 chunk;
- 真机预览验证:分包加载完成后主动
captureException(new Error('sentry test')),确认能上报。
权衡
异步加载会让 SDK 晚于主包就绪,分包加载完成前的异常和请求无法自动补采;初始化时 App() 已注册,首次 Session、启动面包屑等能力也可能缺失,详见初始化时序。需要完整的启动阶段监控时,把 SDK 同步放在主包并在 App() 前初始化。
