本文介绍如何在 Vite/Rollup 构建流程中条件性加载仅用于开发环境的数据库驱动（如 mysql2），避免因引入非边缘兼容包导致构建失败，同时彻底规避 eval 等不安全方案。
本文介绍如何在 vite/rollup 构建流程中条件性加载仅用于开发环境的数据库驱动（如 mysql2），避免因引入非边缘兼容包导致构建失败，同时彻底规避 `eval` 等不安全方案。
在边缘运行时（如 Cloudflare Workers、Vercel Edge Functions）中，Node.js 标准库和大部分第三方包（尤其是依赖 fs、net、child_process 的 mysql2）均不可用。但开发阶段又需连接本地 MySQL 快照进行调试或 CI 测试——这就要求：构建工具必须完全剔除生产环境不需要的 import 语句，而非仅靠运行时条件判断。
关键在于理解构建阶段的“死代码消除”（Tree-shaking）机制：Vite（基于 Rollup）会在 production 模式下自动移除被静态判定为永不执行的代码块。因此，正确做法是使用 编译时环境变量（而非运行时 import.meta.env 或 process.env.NODE_ENV 的动态值）进行条件包裹：
// db.ts
let dbClient: any = null;
// ✅ 正确：使用静态可分析的 process.env.NODE_ENV 判断
if (import.meta.env.DEV) {
// 此 import 仅在开发构建中保留，生产构建时整块被移除
const { createConnection } = await import('mysql2/promise');
dbClient = await createConnection({
host: 'localhost',
user: 'root',
database: 'test'
});
} else if (import.meta.env.VITE_CONNECTOR === 'planetscale') {
// 使用 PlanetScale 边缘兼容连接器
const { connect } = await import('@planetscale/database');
dbClient = connect({ url: import.meta.env.VITE_PLANETSCALE_URL });
}
export { dbClient };⚠️ 注意事项：
- 必须使用 import.meta.env.DEV（Vite 内置布尔常量），它在构建时被硬编码为 true/false，Rollup 可据此精准执行 tree-shaking；
- ❌ 避免 process.env.NODE_ENV === 'development' —— Vite 默认不注入 process.env，且该写法在 ESM 环境中可能触发警告；
- ❌ 禁止使用 eval('import(...)') 或动态字符串拼接 import，这不仅绕过构建检查、破坏类型推导，更存在严重安全与维护风险；
- mysql2 应保留在 dependencies（非 devDependencies），因为 Vite 构建时仍需解析其模块图——但只要 import 被静态条件包裹，它就不会进入最终产物。
此外，建议在 vite.config.ts 中显式配置以强化行为确定性：
// vite.config.ts
export default defineConfig({
build: {
rollupOptions: {
// 确保 DEV 环境变量在构建时被静态替换
plugins: [
replace({
values: {
'import.meta.env.DEV': JSON.stringify(process.env.NODE_ENV === 'development'),
},
preventAssignment: true,
}),
],
},
},
});总结：边缘应用的包隔离本质是构建时策略，而非运行时技巧。通过 import.meta.env.DEV 配合 Vite 的静态分析能力，既能保障开发体验，又能生成纯净、安全、符合边缘规范的生产代码——优雅替代所有 hack 方案。
