JeecgBoot项目环境变量配置与请求路径问题解析

问题背景

在JeecgBoot 3.7.0版本中，开发者遇到了一个关于环境变量配置与实际请求路径不一致的问题。具体表现为：在.env.prod生产环境配置文件中设置了VITE_GLOB_DOMAIN_URL为后端API地址（如https://xxx.com），但实际部署后前端请求的却是前端部署的域名（如https://xxxadmin.com）。

环境变量配置机制

JeecgBoot前端项目使用Vite构建工具，其环境变量配置遵循Vite的规范：

1. .env - 所有环境通用配置
2. .env.development - 开发环境配置
3. .env.production - 生产环境配置

关键环境变量包括：

• VITE_GLOB_DOMAIN_URL：后端API基础地址
• VITE_GLOB_API_URL：API接口路径前缀

问题分析

从技术实现角度看，这种请求路径不一致问题可能由以下几个原因导致：

1. 代理配置冲突：项目可能存在多处代理配置，导致请求路径被重写
2. 环境变量加载顺序：不同环境变量的加载优先级可能影响最终结果
3. 构建时变量替换：构建过程中变量替换可能未按预期执行
4. 运行时配置覆盖：某些运行时逻辑可能覆盖了环境变量配置

解决方案建议

1. 检查代理配置

在vite.config.ts或相关配置文件中，确认代理设置是否正确：

server: {
  proxy: {
    '/api': {
      target: process.env.VITE_GLOB_DOMAIN_URL,
      changeOrigin: true,
      rewrite: (path) => path.replace(/^\/api/, '')
    }
  }
}

2. 验证环境变量加载

确保生产环境构建时正确加载了.env.prod文件：

vite build --mode production

3. 检查请求封装逻辑

审查src/utils/http/request.ts等请求封装文件，确认请求基础URL是否从环境变量正确获取：

const baseURL = import.meta.env.VITE_GLOB_DOMAIN_URL;

4. 部署配置检查

在部署环境中，确认：

• 构建产物是否包含正确的环境变量
• 服务器配置是否重写了请求路径
• 是否存在CDN或反向代理的干扰

最佳实践建议

1. 明确环境区分：严格区分开发、测试和生产环境的配置
2. 统一配置管理：将API相关配置集中管理，避免分散
3. 构建验证：构建后检查生成的配置文件是否包含预期值
4. 日志输出：在关键位置添加环境变量值的日志输出，便于调试

总结

JeecgBoot项目中的请求路径问题通常与环境变量配置和代理设置相关。开发者应系统性地检查从配置到请求的完整链路，确保各环节配置一致。理解Vite环境变量的工作机制和项目特定的请求封装逻辑，是解决此类问题的关键。