S4Hana(ERP)后端未返回本地化报错：Cloud SDK重复添加sap-language头

问题背景 #

基于CAP Java Stack与DWC框架构建的应用，在异步调用S4后端时，手动添加的sap-language头（如de）会被Cloud SDK自动追加的默认en头覆盖，导致S4后端返回英文错误信息，无法匹配用户Locale。

问题解答 #

1. 应用层能否配置Cloud SDK优先使用自定义传入的sap-language头？ #

可以。Cloud SDK允许通过上下文传递、目标定制等方式，优先使用自定义的Locale设置，避免重复生成sap-language头。

2. 这是否属于Cloud SDK的Bug？ #

不属于典型Bug，是异步场景下的上下文传递缺失引发的预期外行为：

• 异步线程未继承原请求的Locale上下文，导致LocaleAccessor fallback到系统默认Locale（en）；
• Cloud SDK的DefaultErpHttpDestination默认会自动添加sap-language头，未检查用户是否已显式传入该头，属于设计上的默认行为，但在异步场景下会引发冲突。

3. 解决方案建议 #

方案一：传递Locale上下文到异步线程（推荐）

在异步任务执行前，手动设置当前线程的Locale上下文，让Cloud SDK自动生成正确的sap-language头，无需手动添加：

// 从DWC头容器获取用户Accept-Language并解析为Locale
String acceptLanguage = dwcHeaderContainer.getHeader(HttpHeaders.ACCEPT_LANGUAGE);
Locale userLocale = Locale.forLanguageTag(acceptLanguage);

// 设置当前线程的Locale上下文
LocaleAccessor.setCurrentLocale(userLocale);

// 直接调用S4服务，Cloud SDK会自动生成匹配用户Locale的sap-language头
ModificationResponse<PurchaseRequisition> s4ReqResponse = 
s4opRequistionService.createPurchaseRequisition(s4opRequistion)
    .executeRequest(destinationProvider.getDestination());

方案二：定制目标并指定Locale

基于现有目标构建自定义ErpHttpDestination，显式设置用户Locale，覆盖系统默认值：

// 解析用户Locale
String acceptLanguage = dwcHeaderContainer.getHeader(HttpHeaders.ACCEPT_LANGUAGE);
Locale userLocale = Locale.forLanguageTag(acceptLanguage);

// 构建带指定Locale的定制目标
ErpHttpDestination customDestination = DefaultErpHttpDestination.builder(destinationProvider.getDestination())
    .locale(userLocale)
    .build();

// 使用定制目标发起请求，Cloud SDK会生成正确的sap-language头
ModificationResponse<PurchaseRequisition> s4ReqResponse = 
s4opRequistionService.createPurchaseRequisition(s4opRequistion)
    .executeRequest(customDestination);

方案三：禁用自动添加sap-language头

通过自定义目标的方法，跳过Cloud SDK自动添加的sap-language头，完全使用手动传入的头：

// 手动构建包含自定义sap-language的请求头
HttpHeaders httpHeaders = new HttpHeaders();
httpHeaders.put(DefaultErpHttpDestination.LOCALE_HEADER_NAME, dwcHeaderContainer.getHeader(HttpHeaders.ACCEPT_LANGUAGE));

// 定制目标，移除自动添加的sap-language头
ErpHttpDestination customDestination = new DefaultErpHttpDestination(destinationProvider.getDestination()) {
    @Override
    public Map<String, List<String>> getHeadersToAdd() {
        Map<String, List<String>> autoHeaders = new HashMap<>(super.getHeadersToAdd());
        autoHeaders.remove(DefaultErpHttpDestination.LOCALE_HEADER_NAME);
        return autoHeaders;
    }
};

// 发起请求，仅使用手动添加的头
ModificationResponse<PurchaseRequisition> s4ReqResponse = 
s4opRequistionService.createPurchaseRequisition(s4opRequistion)
    .withHeaders(httpHeaders)
    .executeRequest(customDestination);

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