如何修改SAP Spartacus注册表单邮箱重复校验的默认错误提示

针对你的需求，有两种可行的持久化修改方案，均不需要修改node_modules内置代码：

方案1：直接覆盖Spartacus内置翻译（最快实现需求） #

Spartacus原生支持自定义翻译资源覆盖内置文本，是官方推荐的文本定制方案，操作步骤如下：

1. 在你的Angular项目src/assets目录下新建i18n文件夹，添加对应语言的翻译文件（以英文为例，新建en.json），写入如下内容：

{
  "httpHandlers": {
    "validationErrors": {
      "invalid": {
        "uid": "Email address is not valid or it is already in use"
      }
    }
  }
}

如果需要适配中文，同理新增zh-CN.json配置对应中文提示即可。
2. 在项目根模块（通常是app.module.ts）中注册自定义翻译配置：

import { NgModule } from '@angular/core';
import { ConfigModule, I18nConfig, TranslationChunksConfig } from '@spartacus/core';

// 自定义翻译配置
const customI18nConfig: I18nConfig = {
  i18n: {
    resources: {
      en: {
        httpHandlers: () => import('./assets/i18n/en.json').then(m => m.default)
      },
      // 中文配置示例
      // 'zh-CN': {
      //   httpHandlers: () => import('./assets/i18n/zh-CN.json').then(m => m.default)
      // }
    }
  }
};

// 翻译块配置
const customTranslationChunkConfig: TranslationChunksConfig = {
  httpHandlers: ['httpHandlers']
};

@NgModule({
  imports: [
    // 其他模块导入...
    ConfigModule.withConfig(customI18nConfig),
    ConfigModule.withConfig(customTranslationChunkConfig)
  ]
})
export class AppModule {}

配置完成后Spartacus会优先加载你自定义的翻译文本，自动替换内置的UID is not valid提示，npm install不会影响该配置。

方案2：自定义独立错误码（更规范，可区分不同错误场景） #

当前你复用了内置的field.required错误码，无法区分「邮箱格式错误」和「邮箱已被占用」两种场景，你可以通过自定义错误码实现更精准的提示：

1. 调整后端自定义校验器的错误码定义：

import org.springframework.util.Assert;
import org.springframework.validation.Errors;
import org.springframework.validation.Validator;
public class EmailExistingValidator implements Validator {
    /*
    ...
    */
    @Override
    public void validate(Object o, Errors errors) {
        Object fieldValue = errors.getFieldValue(this.fieldPath);

        if (fieldValue == null || (fieldValue instanceof String && userIdExists((String) fieldValue))) {
            // 替换为自定义错误码
            errors.rejectValue(this.fieldPath, "email.already.used", new String[]{this.fieldPath}, "This email is already in use.");
        }
    }
}

2. 前端在自定义翻译文件中新增对应错误码的翻译配置：

{
  "httpHandlers": {
    "validationErrors": {
      "email": {
        "already": {
          "used": {
            "uid": "This email address is already registered, please log in directly or use another email"
          }
        }
      },
      "invalid": {
        "uid": "Email address format is not valid"
      }
    }
  }
}

该方案可以实现两种错误场景显示不同的提示，用户体验更优。

新手补充知识点 #

• Spartacus所有内置文本都可以通过上述自定义翻译的方式覆盖，永远不要直接修改node_modules下的依赖包代码，否则依赖重装后修改会丢失。
• Hybris后端校验抛出的错误reason（即你定义的错误码）和subject（即校验字段，这里是uid）会直接拼接成前端的翻译key，自定义校验时建议使用独立的业务错误码，不要复用系统内置错误码，避免和原有逻辑冲突。
• 如果有更复杂的错误处理需求，你也可以自定义HttpErrorInterceptor替换Spartacus内置的错误处理逻辑，但当前场景下覆盖翻译即可满足需求，无需做重度改造。

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