Node+TS项目用字符串索引本地JSON提示隐式any类型如何解决

错误产生原因 #

TypeScript 导入本地JSON文件时，会自动基于JSON的实际内容生成精准的约束类型：你当前的product.json仅包含CT、CC两个固定键，因此TS推导的getProperty类型是仅包含这两个属性的对象，默认不支持任意字符串作为索引取值。
你传入的codProduct是string类型，转大写后仍为string类型，TS无法保证这个字符串一定匹配JSON中已有的两个键，因此触发了「不存在string类型的索引签名」的报错。

可用修复方案 #

下面提供三种不同场景的修复方式，可根据你的项目需求选择：

• 方案1：最简类型断言，适合JSON配置固定、不会频繁新增键的场景
  直接在索引取值时，将key断言为JSON的合法键类型即可，修改utils.ts中的取值逻辑：

  // 把索引的key做类型断言
  const productKey = codProduct.toUpperCase() as keyof typeof getProperty;
  if (getProperty[productKey]) {
      result = {
          name: getProperty[productKey].name,
          price: getProperty[productKey].price
      }
  } else {
      result = { error: "ERROR" }
  }
  

• 方案2：显式定义带索引签名的JSON类型，适合后续会新增产品配置键的场景
  先定义允许任意字符串为键的配置类型，导入JSON时做整体断言：

  // 可以写在model.ts中，也可以直接写在utils.ts顶部
  interface ProductConfig {
    [key: string]: {
      name: string;
      price: string;
    }
  }
  // 替换原有的导入逻辑
  import * as productJson from '../json/product.json';
  const getProperty = productJson as ProductConfig;
  

  改完后原有的getProperty[codProduct.toUpperCase()]取值逻辑不需要修改，不会再触发报错。
• 方案3：运行时+类型双重校验，安全度最高
  如果需要严格保证取值的合法性，避免断言逻辑写错导致运行时报错，可以先提取合法键列表做校验：

  const allowedKeys = Object.keys(getProperty);
  const upperCod = codProduct.toUpperCase();
  if (allowedKeys.includes(upperCod)) {
    const product = getProperty[upperCod as keyof typeof getProperty];
    result = { name: product.name, price: product.price };
  } else {
    result = { error: "ERROR" };
  }
  

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