如何在Node.js（Nest.js）中实现FHIR的_include查询

一、从零搭建FHIR服务器是否合理？有哪些替代方案？ #

• 从零搭建的合理性：如果你已经投入大量工作，且业务逻辑高度定制化，从零搭建完全合理——它能让你完全掌控服务器的每一个细节，适配独特的业务规则。但要注意，FHIR标准本身复杂度高，需要处理资源校验、RESTful API规范、搜索参数、版本管理等大量基础功能，后续维护成本会比较高。
• 替代方案：
  • 托管式FHIR服务：比如Azure Health Data Services中的FHIR服务，这类服务已经封装了FHIR的核心规范，你只需要专注于业务逻辑开发，不用操心底层的合规性、扩容、基础API维护，适合快速上线或业务逻辑相对通用的场景。
  • 开源FHIR服务器框架：基于Node.js的话，可以用现成的开源库（如fhir.js、hapi-fhir），这些框架已经实现了FHIR的基础功能，你可以在其之上扩展业务逻辑，平衡定制性和开发效率。

二、Node.js从零实现_include查询参数的技巧 #

_include的核心是根据主资源关联的引用字段，自动拉取关联资源，以下是实现思路：

1. 解析查询参数：从请求URL中提取_include参数，格式通常为_include=[资源类型]:[引用字段]（比如_include=Patient:generalPractitioner），拆解出要关联的资源类型和对应的引用字段。
2. 查询主资源：先执行基础查询获取主资源集合，比如查询所有Encounter资源。
3. 提取关联引用：遍历主资源，收集所有符合_include指定字段的引用ID，注意去重避免重复查询。
4. 批量查询关联资源：根据收集到的ID，批量查询对应的关联资源（比如上述例子中的Practitioner资源）。
5. 整合返回结果：将主资源和关联资源合并为FHIR规范的Bundle格式返回，确保结构符合标准，便于客户端解析。

简化代码示例 #

// 解析_include参数
function parseIncludeParam(includeStr) {
  const [resourceType, referenceField] = includeStr.split(':');
  return { resourceType, referenceField };
}

// 处理包含_include的查询
async function handleFhirQuery(req) {
  const { _include } = req.query;
  // 1. 查询主资源（以Encounter为例）
  const mainResources = await db.collection('Encounter').find(req.query).toArray();
  
  if (!_include) {
    return { 
      resourceType: 'Bundle', 
      type: 'searchset', 
      entry: mainResources.map(res => ({ resource: res })) 
    };
  }
  
  const { resourceType: targetType, referenceField } = parseIncludeParam(_include);
  // 2. 提取所有去重后的引用ID
  const referenceIds = [...new Set(mainResources
    .map(res => res[referenceField]?.reference)
    .filter(ref => ref?.startsWith(`${targetType}/`))
    .map(ref => ref.split('/')[1]))];
  
  // 3. 批量查询关联资源
  const relatedResources = await db.collection(targetType).find({ id: { $in: referenceIds } }).toArray();
  
  // 4. 整合为Bundle返回
  return {
    resourceType: 'Bundle',
    type: 'searchset',
    entry: [
      ...mainResources.map(res => ({ resource: res })),
      ...relatedResources.map(res => ({ resource: res }))
    ]
  };
}

关键注意事项 #

• 支持多值_include：处理多个_include参数（如_include=A:b&_include=C:d）时，需循环处理每个关联规则。
• 校验引用格式：FHIR引用可能是绝对URL或相对路径，要确保正确提取资源ID。
• 性能优化：用数据库批量查询能力替代循环单查；大数据量场景需考虑分页和缓存。
• 遵循FHIR规范：返回的Bundle要严格符合FHIR结构要求，包括entry的resource、fullUrl等字段。

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