创建Upstash Redis实例遇TypeScript类型错误，求解决方案

问题分析 #

报错核心原因有两点：

1. 环境变量类型不确定：process.env中的变量在TypeScript中默认是string | undefined，而Redis构造函数要求传入非空字符串。
2. 版本参数不兼容：@upstash/redis v2.x版本修改了初始化参数的字段名，从url/token改为restUrl/restToken，使用旧字段名会触发类型校验错误。

解决方案 #

方案1：适配@upstash/redis v2.x版本（推荐） #

v2.x版本提供了自动读取环境变量的简化初始化方式：

import { Redis } from '@upstash/redis'

// 自动读取.env.local中的UPSTASH_REDIS_REST_URL和UPSTASH_REDIS_REST_TOKEN
export const db = Redis.fromEnv()

如果需要手动传入参数，需使用新字段名：

import { Redis } from '@upstash/redis'

// 用!断言变量非空，或提前做存在性检查
export const db: Redis = new Redis({
  restUrl: process.env.UPSTASH_REDIS_REST_URL!,
  restToken: process.env.UPSTASH_REDIS_REST_TOKEN!
})

方案2：适配@upstash/redis v1.x版本 #

若使用v1.x版本，保持url/token字段名，但必须确保环境变量非空：

import { Redis } from '@upstash/redis'

const redisUrl = process.env.UPSTASH_REDIS_REST_URL
const redisToken = process.env.UPSTASH_REDIS_REST_TOKEN

// 提前检查变量是否存在，避免运行时错误
if (!redisUrl || !redisToken) {
  throw new Error('请配置UPSTASH_REDIS_REST_URL和UPSTASH_REDIS_REST_TOKEN环境变量')
}

export const db: Redis = new Redis({
  url: redisUrl,
  token: redisToken
})

额外检查步骤 #

• 确认.env.local文件在项目根目录，变量名拼写完全正确：

  UPSTASH_REDIS_REST_URL=你的Redis地址
  UPSTASH_REDIS_REST_TOKEN=你的Redis令牌
  

• 如果是Next.js等框架，修改环境变量后需重启开发服务器才能生效。
• 运行npm list @upstash/redis确认当前安装版本，对应选择上述方案。

内容的提问来源于stack exchange，提问作者Amit Yadav