SuperAPI AI 工具集

env-validation

部署与运维

查看项目

更新于 10-15 18:45

技能介绍

用途:该配方用于在服务器启动时和构建前校验环境变量,尽早发现缺失或无效的变量,而不是等到相关代码路径执行时才失败。

主要能力:一是在服务器启动阶段校验配置。部分环境变量由依赖包内部读取而非作为参数传入,可在 instrumentation.ts 中通过副作用导入各 config 配置,触发 configSchema 校验;若缺少必需变量,服务器启动即失败并给出明确错误。二是在构建前校验环境文件,提供了一个 validate-env 脚本,安装方式为 shadcn registry:bunx --bun shadcn@latest add https://fullstackrecipes.com/r/validate-env.json,或直接复制源码 scripts/validate-env.ts。脚本会使用 Next.js 的 loadEnvConfig 加载环境文件,扫描 src/lib/*/config.ts,逐个导入以触发校验,并报告缺失或无效变量,同时警告 .env 文件中定义但未被任何配置使用的变量。

使用方式:在 package.json 中添加 prebuild、env:validate、env:validate:prod 脚本。prebuild 会在构建前自动运行校验,适用于本地、CI 和 Vercel;校验失败会以非零退出码提前终止构建,未使用变量仅告警、不会导致构建失败。

适用场景:使用 Next.js、TypeScript 与 configSchema 组织配置,希望统一管理并提前校验环境变量的项目。

限制:资料未提供价格、平台兼容范围、性能数据及更多安装方式;具体实现依赖脚本与约定目录结构,其他框架或目录布局可能需要调整。