TypeScript中如何让无字符串索引接口适配node-redis的JSON存储函数

我正在使用node-redis包存储和检索统计对象，部分代码如下：

export interface ServiceStats {
  readonly id: string;
  readonly startTime: number;
  readonly timestamp: number;
  readonly hostName: string;
  readonly network: number;
  readonly upTime: number;
  readonly stateUpdate?: boolean;
}

async setServiceStats(serviceId: string, stats: ServiceStats) {
  this.client.json.set(serviceId, '$', stats); // 此行报错
}

报错原因是ServiceStats接口缺少字符串索引签名，错误信息：

Type at position 2 in source is not compatible with type at position 2 in target.
      Type 'ServiceStats' is not assignable to type 'RedisJSON'.
        Type 'ServiceStats' is not assignable to type 'RedisJSONObject'.
          Index signature for type 'string' is missing in type 'ServiceStats'.ts(2345)

不想使用stats as any消除错误，也不愿修改原接口（实际ServiceStats更复杂且包含多层级，但仍是合法JSON），可以用以下几种方案解决：

方案1：使用类型安全的断言函数 #

创建通用函数将目标对象断言为RedisJSON类型，避免直接使用any：

import type { RedisJSON } from '@redis/client';

function toRedisJSON<T extends object>(obj: T): RedisJSON {
  return obj as RedisJSON;
}

// 调用方式
async setServiceStats(serviceId: string, stats: ServiceStats) {
  this.client.json.set(serviceId, '$', toRedisJSON(stats));
}

优点：无运行时开销，类型安全，代码简洁；缺点：依赖类型断言，需确保对象确实符合JSON结构。

方案2：断言为Record<string, unknown> #

直接将stats断言为Record<string, unknown>，这是RedisJSONObject的兼容类型，比any更具类型约束：

async setServiceStats(serviceId: string, stats: ServiceStats) {
  this.client.json.set(serviceId, '$', stats as Record<string, unknown>);
}

优点：代码最简洁，无额外函数；缺点：仍需类型断言，但比any更安全。

方案3：JSON序列化反序列化 #

通过运行时的序列化-反序列化转换，生成天然兼容RedisJSON的普通JS对象，无需类型断言：

async setServiceStats(serviceId: string, stats: ServiceStats) {
  const compatibleStats = JSON.parse(JSON.stringify(stats));
  this.client.json.set(serviceId, '$', compatibleStats);
}

优点：无需类型断言，运行时保证对象结构，自动处理多层级对象；缺点：存在轻微的序列化性能开销，适合对性能要求不高的场景。

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