使用Hapi FHIR分页遍历资源时display字段缺失的问题排查

可能原因 #

分页请求（loadPage().next()）和初始search()请求的处理逻辑存在差异：

• 初始search()默认携带了触发服务器端CodeSystem生成display值的参数，但分页请求仅复用next链接的基础URL，丢失了关键参数；
• 服务器端对分页请求的资源序列化做了简化，跳过了根据code自动生成display的步骤。

可行解决方案 #

1. 复用初始搜索参数构建分页请求

放弃直接使用loadPage().next()，而是基于初始搜索的参数手动构造分页请求，确保所有必要参数被完整传递：

// 初始搜索请求
Bundle initialBundle = fhirClient.search()
    .forResource(request.type)
    .returnBundle(classOf[Bundle])
    .execute();
resources.addAll(getResourcesFromBundle(initialBundle));

// 处理分页逻辑
String nextUrl = initialBundle.getLink(IBaseBundle.LINK_NEXT) != null ? initialBundle.getLink(IBaseBundle.LINK_NEXT).getUrl() : null;
while (nextUrl != null) {
    nextUrl = FhirUtils.replaceBaseUrl(nextUrl, fhirClient.getServerBase);
    // 用fromUrl复用next链接的参数，同时继承初始搜索的配置
    Bundle nextBundle = fhirClient.search()
        .forResource(request.type)
        .fromUrl(nextUrl)
        .returnBundle(classOf[Bundle])
        .execute();
    resources.addAll(getResourcesFromBundle(nextBundle));
    nextUrl = nextBundle.getLink(IBaseBundle.LINK_NEXT) != null ? nextBundle.getLink(IBaseBundle.LINK_NEXT).getUrl() : null;
}

2. 客户端本地生成display字段

如果服务器分页响应确实不返回display，可以在客户端维护对应CodeSystem的映射表，根据资源的code值手动补全display：

// 示例：本地维护CodeSystem的code-display映射
private static final Map<String, String> CODE_DISPLAY_MAP = new HashMap<>();
static {
    CODE_DISPLAY_MAP.put("blood", "静脉血样本");
    CODE_DISPLAY_MAP.put("urine", "尿液样本");
    // 补充其他code与display的对应关系
}

// 处理Bundle资源时补全display
private List<Specimen> getResourcesFromBundle(Bundle bundle) {
    List<Specimen> specimens = new ArrayList<>();
    for (Bundle.BundleEntryComponent entry : bundle.getEntry()) {
        if (entry.getResource() instanceof Specimen) {
            Specimen specimen = (Specimen) entry.getResource();
            if (specimen.getType() != null && specimen.getType().getCoding() != null) {
                for (Coding coding : specimen.getType().getCoding()) {
                    // 若display为空，从本地映射获取对应值
                    if (coding.getDisplay() == null && CODE_DISPLAY_MAP.containsKey(coding.getCode())) {
                        coding.setDisplay(CODE_DISPLAY_MAP.get(coding.getCode()));
                    }
                }
            }
            specimens.add(specimen);
        }
    }
    return specimens;
}

3. 排查服务器端配置

直接复制分页的next链接到浏览器或API测试工具中发起请求，查看返回的Bundle是否包含display字段：

• 如果返回结果有display，说明是客户端分页请求的参数或构造方式存在问题；
• 如果返回结果也没有display，需要联系服务器端开发人员，确认分页请求是否触发了CodeSystem的display生成逻辑。

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