TypeScript中CASL结合Prisma时“参数不可分配”错误的解决方法

问题原因 #

你遇到的ts(2345)错误是因为CASL的类型系统期望传入的subject是完整的user模型类型，但你通过subject函数传入的是仅包含id属性的对象，缺少user类型定义的其他必填属性（如googleId、email等），导致类型不匹配。

解决方案 #

方案1：使用Partial类型放宽Subject要求 #

修改AppAbility中的Subject类型为Partial<user>，允许传入仅包含部分属性的user对象：

import { user } from '@prisma/client';
import { PureAbility, AbilityBuilder, subject } from '@casl/ability';
import { createPrismaAbility, PrismaQuery, Subjects } from '@casl/prisma';

type AppAbility = PureAbility<
  [
    string,
    Subjects<{
      user: Partial<user>; // 将完整user类型改为Partial<user>
    }>,
  ],
  PrismaQuery
>;
const { can, build } = new AbilityBuilder<AppAbility>(createPrismaAbility);

can('read', 'user', { id: 1 });

const ability = build();
ability.can('read', 'user');

console.log(ability.can('read', subject('user', { id: 1 }))); // 不再报错

说明：Partial<user>会把user类型的所有属性转为可选，TypeScript会认可仅包含id的对象符合类型要求，且CASL的权限判断逻辑不受影响（仅检查规则中定义的id属性）。

方案2：自定义灵活的Subject类型 #

如果需要同时支持完整user实例和部分属性对象的场景，可以自定义Subject类型：

import { user } from '@prisma/client';
import { PureAbility, AbilityBuilder, subject } from '@casl/ability';
import { createPrismaAbility, PrismaQuery, Subjects, Model } from '@casl/prisma';

// 定义支持完整模型或仅带id的部分对象的Subject类型
type UserSubject = Model<user, 'user'> | Pick<user, 'id'>;

type AppAbility = PureAbility<
  [
    string,
    Subjects<{
      user: UserSubject;
    }>,
  ],
  PrismaQuery
>;
const { can, build } = new AbilityBuilder<AppAbility>(createPrismaAbility);

can('read', 'user', { id: 1 });

const ability = build();
console.log(ability.can('read', subject('user', { id: 1 }))); // 正常工作
// 也支持传入完整user实例
console.log(ability.can('read', subject('user', { id: 1, email: 'test@example.com', password: 'xxx' })));

说明：Pick<user, 'id'>精确指定仅允许id属性，比Partial更严格；Model<user, 'user'>对应完整的Prisma模型实例，兼顾两种使用场景。

方案3：局部类型断言（临时方案） #

若不想修改全局Subject类型，可以在调用subject时使用精确的类型断言替代any：

console.log(ability.can('read', subject('user', { id: 1 }) as Pick<user, 'id'>));

说明：Pick<user, 'id'>仅选取user类型中的id属性，比any更安全，不会完全丢失类型检查能力。

内容的提问来源于stack exchange，提问作者Đoàn Đức Bảo