Vike项目中避免在生产环境加载Vite的实践指南

在Vike（原vite-plugin-ssr）项目中，开发团队遇到了一个典型的生产环境构建问题。当项目在Github Actions中执行构建时，系统抛出了一个关键错误，提示在生产环境中意外加载了Vite开发服务器。

问题现象

项目在CI环境中运行时，控制台显示如下错误信息：

Error: [vike@0.4.159][Bug] You stumbled upon a bug in Vike's source code...

错误发生在assertIsNotProductionRuntime.js文件中，具体是检测到了Vite在生产环境中的不当加载。

问题根源分析

经过深入排查，发现问题出在服务端启动逻辑中。虽然代码通过NODE_ENV判断了运行环境，但Vite配置对象却被意外地包含在了生产环境构建中。具体表现为：

1. 开发环境判断逻辑正确执行，打印了"Non-development env"日志
2. 但Vite相关的配置对象仍被包含在最终构建产物中
3. Vike的运行时检测机制发现了这一异常情况

解决方案

最终解决方案是简化Vite开发服务器的配置方式，避免引入完整的开发配置对象。具体修改如下：

原代码：

if (process.env.NODE_ENV === 'development') {
  const vite = await import('vite')
  const viteDevMiddleware = (await vite.createServer(devConfig)).middlewares
  app.use(viteDevMiddleware)
}

优化后代码：

if (process.env.NODE_ENV === 'development') {
  const vite = await import('vite')
  const viteDevMiddleware = (await vite.createServer({ 
    server: { middlewareMode: true } 
  })).middlewares
  app.use(viteDevMiddleware)
}

技术要点

1. 环境隔离原则：生产环境和开发环境的资源应该严格隔离
2. 配置精简：开发环境配置应保持最小化，避免引入不必要的内容
3. 构建检测：Vike提供的检测机制能有效防止内存泄漏等问题

最佳实践建议

1. 避免在服务端代码中直接引入完整的Vite配置对象
2. 确保开发环境相关代码不会被打包到生产构建中
3. 使用最小化的配置选项来创建开发服务器中间件
4. 定期检查项目依赖，确保使用最新稳定版本的Vike/Vite

通过这次问题排查，我们更深入地理解了Vike项目中环境隔离的重要性，也为类似问题的解决提供了参考方案。