eggjs · akitaSummer · Mar 10, 2025 · Mar 10, 2025 · Mar 10, 2025 · Mar 10, 2025
diff --git a/README.md b/README.md
@@ -968,6 +968,7 @@ import { ContextHelloType } from '../FooType';
 import { AbstractContextHello } from '../AbstractHello';
 
 @ContextProto()
+// 需要注意的是，对应枚举如果已经被实现，则会报错，若你已经知晓此情况，想覆盖此枚举类型，则增加参数 true 来强制覆盖，例：@Hello(HelloType.BAR, true)
 @Hello(HelloType.BAR)
 export class BarHello extends AbstractHello {
   hello(): string {

diff --git a/core/core-decorator/src/util/QualifierUtil.ts b/core/core-decorator/src/util/QualifierUtil.ts
@@ -4,7 +4,10 @@
 import { MetadataUtil } from './MetadataUtil';
 
 export class QualifierUtil {
-  static addProtoQualifier(clazz: EggProtoImplClass, attribute: QualifierAttribute, value: QualifierValue) {
+  static addProtoQualifier(clazz: EggProtoImplClass, attribute: QualifierAttribute, value: QualifierValue, isForceReplacement?: boolean) {
+    if (QualifierUtil.getQualifierValue(clazz, attribute) && !isForceReplacement) {
+      throw new Error(`Qualifier Error: clazz ${clazz.name} attribute ${attribute.toString()} has been implemented`);
+    }
     const qualifiers = MetadataUtil.initOwnMapMetaData(QUALIFIER_META_DATA, clazz, new Map<QualifierAttribute, QualifierValue>());
     qualifiers.set(attribute, value);
   }

diff --git a/core/dynamic-inject/src/QualifierImplDecoratorUtil.ts b/core/dynamic-inject/src/QualifierImplDecoratorUtil.ts
@@ -4,10 +4,10 @@ import { QualifierImplUtil } from './QualifierImplUtil';
 
 export class QualifierImplDecoratorUtil {
   static generatorDecorator<T extends object, Enum extends ImplTypeEnum>(abstractClazz: EggAbstractClazz<T>, attribute: QualifierAttribute): ImplDecorator<T, Enum> {
-    return function(type: Enum[keyof Enum]) {
+    return function(type: Enum[keyof Enum], isForceReplacement?: boolean) {
       return function(clazz: EggProtoImplClass<T>) {
-        QualifierImplUtil.addQualifierImpl(abstractClazz, type, clazz);
-        QualifierUtil.addProtoQualifier(clazz, attribute, type);
+        QualifierImplUtil.addQualifierImpl(abstractClazz, type, clazz, isForceReplacement);
+        QualifierUtil.addProtoQualifier(clazz, attribute, type, isForceReplacement);
       };
     };
   }

diff --git a/core/dynamic-inject/src/QualifierImplUtil.ts b/core/dynamic-inject/src/QualifierImplUtil.ts
@@ -3,7 +3,10 @@
 import type { EggAbstractClazz, EggProtoImplClass, QualifierValue } from '@eggjs/tegg-types';
 
 export class QualifierImplUtil {
-  static addQualifierImpl(abstractClazz: EggAbstractClazz, qualifierValue: QualifierValue, implClazz: EggProtoImplClass) {
+  static addQualifierImpl(abstractClazz: EggAbstractClazz, qualifierValue: QualifierValue, implClazz: EggProtoImplClass, isForceReplacement?: boolean) {
+    if (QualifierImplUtil.getQualifierImp(abstractClazz, qualifierValue) && !isForceReplacement) {
+      throw new Error(`Qualifier Error: abstractClazz ${abstractClazz.name} qualifierValue ${qualifierValue.toString()} has been implemented`);
+    }
     const implMap = MetadataUtil.initOwnMapMetaData(QUALIFIER_IMPL_MAP, abstractClazz as unknown as EggProtoImplClass, new Map());
     implMap.set(qualifierValue, implClazz);
   }

diff --git a/core/types/dynamic-inject.ts b/core/types/dynamic-inject.ts
@@ -5,7 +5,7 @@ export type ImplTypeEnum = {
   [id: string]: QualifierValue;
 };
 
-export type ImplDecorator<T extends object, Enum extends ImplTypeEnum> = (type: Enum[keyof Enum]) => ((clazz: EggProtoImplClass<T>) => void);
+export type ImplDecorator<T extends object, Enum extends ImplTypeEnum> = (type: Enum[keyof Enum], isForceReplacement?: boolean) => ((clazz: EggProtoImplClass<T>) => void);
 
 export interface EggObjectFactory {
   getEggObject<T extends object>(abstractClazz: EggAbstractClazz<T>, qualifierValue: QualifierValue): Promise<T>;

diff --git a/plugin/tegg/lib/AppLoadUnit.ts b/plugin/tegg/lib/AppLoadUnit.ts
@@ -49,7 +49,7 @@ export class AppLoadUnit implements LoadUnit {
         value: this.name,
       }];
       defaultQualifier.forEach(qualifier => {
-        QualifierUtil.addProtoQualifier(clazz, qualifier.attribute, qualifier.value);
+        QualifierUtil.addProtoQualifier(clazz, qualifier.attribute, qualifier.value, true);
       });
       const protos = await EggPrototypeCreatorFactory.createProto(clazz, this);
       for (const proto of protos) {