在t3-env中实现环境变量在不同环境的条件验证

环境变量验证的灵活需求

在现代Web应用开发中，环境变量的管理是一个重要课题。我们经常需要在不同环境下对变量进行不同严格程度的验证。例如，在开发环境中，某些第三方服务的API密钥可以设置为空或可选，但在生产环境中则必须严格验证其存在性。

t3-env的条件验证方案

t3-env项目基于Zod提供了灵活的环境变量验证机制。通过结合环境判断和Zod的验证方法，我们可以轻松实现不同环境下的差异化验证。

实现原理

核心思路是利用Zod的条件验证方法，结合当前环境判断来动态调整验证规则：

const isProd = process.env.VERCEL_ENV === "production";

export const env = createEnv({
  server: {
    REQUIRED_IN_PROD: isProd ? z.string() : z.string().optional(),
  },
});

详细解析

1. 环境判断：首先通过process.env.VERCEL_ENV或其他环境标识判断当前是否为生产环境
2. 条件验证：使用三元运算符动态选择验证规则
   • 生产环境：使用z.string()强制要求变量存在且非空
   • 非生产环境：使用z.string().optional()使变量变为可选

实际应用场景

这种模式特别适用于以下情况：

• 第三方服务集成（如分析、监控工具）
• 功能开关
• 不同环境的差异化配置
• 开发环境下的模拟服务配置

高级用法

除了基本的字符串验证，还可以结合其他Zod方法实现更复杂的条件验证：

TELEMETRY_TOKEN: isProd 
  ? z.string().min(32, "生产环境需要有效的32位令牌") 
  : z.string().optional(),

注意事项

1. 确保环境判断逻辑准确可靠
2. 考虑CI/CD环境下的特殊处理
3. 文档中明确说明各变量的环境要求
4. 类型系统会正确反映变量的可选性

通过这种模式，开发者可以在保持类型安全的同时，灵活处理不同环境下的配置需求，既保证了生产环境的严谨性，又兼顾了开发环境的便利性。