TypeScript TS4094报错：导出类的私有/受保护属性问题如何解决？

遇到的问题是继承Pocketbase类并重写collection方法时，TS抛出4094错误，提示返回类型中的私有/受保护成员不能出现在导出类的公共接口中，且@ts-ignore等注释无法生效。以下是几种可行的解决办法：

方法1：通过类型断言过滤私有成员 #

重写方法时，将返回值断言为仅包含你需要的公共方法的类型，绕开TS对私有成员的检查：

// 先定义需要用到的公共方法集合，按需添加
type PublicCollection = Pick<ReturnType<Pocketbase['collection']>, 
  'getOne' | 'getList' | 'create' | 'update' | 'delete'>;

export class PocketbaseService extends Pocketbase {
    constructor(baseUrl: string) {
        super(baseUrl);
    }

    collection(collection: Collections): PublicCollection {
        return super.collection(collection) as PublicCollection;
    }
}

这种方式既能保留业务所需的公共API，又能规避私有成员带来的类型错误。

方法2：用类型重载替代完全重写 #

如果只是想约束collection方法的参数类型，不需要修改原有逻辑，可以用类型重载代替重写操作，避免触发返回类型的兼容性检查：

export class PocketbaseService extends Pocketbase {
    constructor(baseUrl: string) {
        super(baseUrl);
    }

    // 重载签名：约束参数为Collections类型
    collection<T extends Collections>(collection: T): ReturnType<Pocketbase['collection']>;
    // 保留原方法的字符串参数支持
    collection(collection: string): ReturnType<Pocketbase['collection']>;
    // 实现签名：直接调用父类方法
    collection(collection: any) {
        return super.collection(collection);
    }
}

这样既实现了参数类型约束，又不会触发私有成员相关的TS错误。

方法3：全局禁用特定错误（兜底方案） #

如果上述方法都不适用，可以通过TS配置放宽检查，但会降低项目类型严格性，需谨慎使用：
在tsconfig.json中添加配置：

{
  "compilerOptions": {
    "skipLibCheck": true, // 跳过第三方库的类型检查
    "noImplicitOverride": false // 关闭隐式重写的严格校验
  }
}

或者在文件顶部添加// @ts-nocheck，忽略整个文件的TS错误，但这是最后的兜底手段。

错误原因说明 #

TS4094错误的核心是：子类重写父类方法后，返回类型包含父类的私有/受保护成员，而这些成员不允许出现在导出类的公共接口中。@ts-ignore无效是因为错误并非来自当前行，而是源于返回类型的深层类型检查，因此需要从返回类型本身入手解决。

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