如何修复动态对象的TS2533/TS2532空值类型错误

问题背景 #

使用Google Chat API的Schema$CommonEventObject接口编写TypeScript代码时，开启strictNullChecks=true后触发以下错误：

TS2532: Object is possibly 'undefined'.
TS2533: Object is possibly 'null' or 'undefined'

代码示例：

interface Schema$CommonEventObject {
        formInputs?: {
            [key: string]: Schema$Inputs;
        } | null;
     }
interface Schema$Inputs {
        stringInputs?: Schema$StringInputs;
    }
interface Schema$StringInputs {
        value?: string[] | null;
    }
const commonEvent: Schema$CommonEventObject = event?.common ?? {};
const formValues = commonEvent.formInputs ?? {};
const topic = formValues?.['topic']?.stringInputs?.value[0];
const isAnonymous = formValues?.['is_anonymous']?.stringInputs.value[0] === '1';

尝试空值合并运算符（?? ''）仍报错，使用非空断言（!）则出现新错误：

TS7053: Element implicitly has an 'any' type because expression of type '"topic"' can't be used to index type 'Schema$Inputs'.   Property 'topic' does not exist on type 'Schema$Inputs'.

解决方案 #

1. 类型守卫+逐层安全访问 #

通过自定义类型守卫明确每一层的类型合法性，同时完成空值校验：

// 类型守卫：判断是否为Schema$StringInputs类型
function isStringInputs(obj: unknown): obj is Schema$StringInputs {
  return typeof obj === 'object' && obj !== null && 'stringInputs' in obj;
}

// 类型守卫：判断value是否为有效字符串数组
function hasValidValue(inputs: Schema$StringInputs): inputs is { value: string[] } {
  return Array.isArray(inputs.value);
}

const commonEvent: Schema$CommonEventObject = event?.common ?? {};
const formValues = commonEvent.formInputs ?? {};

// 处理topic字段
let topic = '';
const topicInput = formValues['topic'];
if (topicInput && isStringInputs(topicInput) && hasValidValue(topicInput.stringInputs)) {
  topic = topicInput.stringInputs.value[0] ?? '';
}

// 处理is_anonymous字段
let isAnonymous = false;
const anonInput = formValues['is_anonymous'];
if (anonInput && isStringInputs(anonInput) && hasValidValue(anonInput.stringInputs)) {
  isAnonymous = anonInput.stringInputs.value[0] === '1';
}

2. 类型断言+可选链+空值合并 #

如果能确定接口返回结构符合预期，可通过类型断言解决索引类型问题，同时保留安全访问：

const commonEvent: Schema$CommonEventObject = event?.common ?? {};
// 断言formValues为明确的键值对类型，解决索引报错
const formValues = commonEvent.formInputs ?? {} as Record<string, Schema$Inputs>;

// 逐层用?.处理可选值，最后用??设置默认值
const topic = formValues['topic']?.stringInputs?.value?.[0] ?? '';
// 对布尔值设置默认false，避免undefined参与比较
const isAnonymous = (formValues['is_anonymous']?.stringInputs?.value?.[0] === '1') ?? false;

3. 扩展原接口（推荐自定义场景） #

如果是自主维护的接口，可扩展原接口明确表单字段，让类型系统直接识别合法键：

// 扩展原接口，定义已知的表单字段
interface ExtendedCommonEventObject extends Omit<Schema$CommonEventObject, 'formInputs'> {
  formInputs?: {
    topic?: Schema$Inputs;
    is_anonymous?: Schema$Inputs;
  } | null;
}

const commonEvent: ExtendedCommonEventObject = event?.common ?? {};
const formValues = commonEvent.formInputs ?? {};

// 直接通过属性访问，无需索引，类型安全
const topic = formValues.topic?.stringInputs?.value?.[0] ?? '';
const isAnonymous = (formValues.is_anonymous?.stringInputs?.value?.[0] === '1') ?? false;

关键说明 #

• 开启strictNullChecks=true时，必须显式处理所有可能为null/undefined的节点，不能依赖隐式类型转换。
• 索引类型报错的核心是原接口的formInputs仅声明了通用字符串索引，TypeScript无法确认'topic'/'is_anonymous'等键的存在性，需通过类型断言、守卫或接口扩展解决。

内容的提问来源于stack exchange，提问作者Muhammad Dyas Yaskur