TypeScript字符串索引接口报错：access属性类型无法分配给索引类型

报错原因 #

你定义的接口中，内部对象同时声明了字符串索引签名（[key: string]: ITest）和access属性（类型为number[]）。TypeScript的规则是：索引签名的类型必须覆盖所有显式声明的属性类型——也就是说access的number[]必须能赋值给索引签名的ITest类型，显然二者类型不匹配，因此触发报错。

具体解决方案 #

方案1：拆分节点类型（推荐）

如果你的数据结构实际是两种节点（带子节点的容器、带access的叶子节点），拆分接口会让类型更清晰：

// 叶子节点：仅包含access属性
interface ITestLeaf {
    access: number[];
}

// 容器节点：包含任意字符串键，值可以是容器或叶子节点
interface ITestContainer {
    [key: string]: ITestContainer | ITestLeaf;
}

// 顶层类型用联合类型涵盖两种节点
type ITest = ITestContainer | ITestLeaf;

方案2：修改索引签名兼容access类型

如果必须在同一对象内共存，将索引签名的类型改为ITest | number[]，让access的类型符合要求：

interface ITest {
    [key: string]: {
        [key: string]: ITest | number[];
        access: number[];
    };
}

注意：这种方式会让子节点类型模糊，访问时可能需要额外的类型判断，可读性不如方案1。

方案3：交叉类型合并（不推荐，易混淆）

用交叉类型将索引签名和access属性强行合并，但使用时需要类型断言，实用性较低：

type ITestInner = {
    access: number[];
} & {
    [key: string]: ITest;
};

interface ITest {
    [key: string]: ITestInner;
}

内容的提问来源于stack exchange，提问作者Paweł Baca