如何修复Zod中的`any`类型不安全参数及类型不兼容错误？

StackBlitz类型不匹配错误 #

原因 #

Zod v3.22.4中z.object()默认启用strip模式，该模式下TypeScript的类型推断会错误地将嵌套对象的必填属性标记为可选类型。当你显式指定z.ZodType<BuildCommandToDecompressWithUnarchiver>时，Zod自动推断的类型与手动定义的接口类型产生冲突，导致path属性被判定为可选，与接口中必填的定义矛盾。

修复方法 #

给所有嵌套的z.object()添加.strict()方法，强制开启严格模式，确保Zod推断的类型与手动定义的接口完全一致：

// 给嵌套的directory对象添加strict()
directory: z.object({ path: z.string() }).strict()
// 同理给input下的file对象添加
file: z.object({ path: z.string() }).strict()

或者在顶层z.object()的第二个参数中配置strict: true，全局启用严格模式：

z.object({
  // ... 其他属性定义
}, { strict: true })

本地ESLint不安全参数错误 #

原因 #

函数buildCommandToDecompressWithUnarchiver的参数source未指定类型，TypeScript将其推断为any。尽管Zod的parse方法会校验并返回正确类型，但ESLint的@typescript-eslint/no-unsafe-argument规则无法识别Zod的类型保障，仍判定input.password为不安全的any类型。

修复方法 #

给函数参数source指定unknown类型（推荐，符合Zod校验的最佳实践），或直接指定为BuildCommandToDecompressWithUnarchiver类型：

export function buildCommandToDecompressWithUnarchiver(source: unknown) {
  // ... 原有逻辑
}

指定类型后，TypeScript和ESLint能正确识别input的类型，无需使用as string强制类型转换。

修改后的完整代码 #

import { z } from 'zod';

type BuildCommandToDecompressWithUnarchiver = {
  overwrite?: boolean;
  password?: string;
  output: {
    directory: {
      path: string;
    };
  };
  input: {
    file: {
      path: string;
    };
  };
};

const BuildCommandToDecompressWithUnarchiverModel: z.ZodType<BuildCommandToDecompressWithUnarchiver> =
  z.object({
    overwrite: z.optional(z.boolean()).default(false),
    password: z.optional(z.string()),
    output: z.object({
      directory: z.object({
        path: z.string(),
      }).strict(),
    }).strict(),
    input: z.object({
      file: z.object({
        path: z.string(),
      }).strict(),
    }).strict(),
  }, { strict: true });

export function buildCommandToDecompressWithUnarchiver(source: unknown) {
  const input = BuildCommandToDecompressWithUnarchiverModel.parse(source);
  const cmd = [
    `unar`,
    `${input.input.file.path}`,
    `-o`,
    `${input.output.directory.path}`,
  ];

  cmd.push('--quiet');

  if (input.overwrite) {
    cmd.push(`-f`);
  }

  if (input.password) {
    cmd.push(`-p`, input.password);
  }

  return cmd;
}

console.log(
  BuildCommandToDecompressWithUnarchiverModel.parse({
    output: {
      directory: {
        path: 'foo',
      },
    },
    input: {
      file: {
        path: 'x.zip',
      },
    },
  })
);

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