Swagger UI开启docExpansion:none时deepLinking失效问题求助

针对你遇到的Swagger UI 5.11.8在docExpansion: none配置下深度链接无法打开对应API方法的问题，以下是几个可行的解决选项：

• 自定义初始化脚本强制展开目标接口
  由于docExpansion: none会默认折叠所有标签，深度链接的自动展开逻辑可能未被触发。可以在页面加载后添加一段脚本，解析URL哈希值，找到目标接口所在的折叠标签并展开，再滚动到目标位置：

  document.addEventListener('DOMContentLoaded', function() {
    const hash = window.location.hash.slice(1);
    if (!hash) return;
  
    // 匹配operationId或路径对应的元素
    const target = document.querySelector(`[data-operation-id="${hash}"]`) || document.querySelector(`a[href="#${hash}"]`);
    if (!target) return;
  
    // 展开父级折叠区块
    const collapsedSection = target.closest('.opblock-section.is-collapsed');
    if (collapsedSection) {
      collapsedSection.classList.remove('is-collapsed');
      collapsedSection.dispatchEvent(new Event('click'));
    }
  
    // 滚动到目标接口
    target.scrollIntoView({ behavior: 'smooth', block: 'center' });
  });
  

• 切换Swagger UI版本
  这可能是5.11.8版本的兼容性bug，尝试降级到5.10.x系列或升级到最新的5.12.x及以上版本，验证深度链接功能是否恢复正常。

• 启用persistAuthorization配置
  部分开发者反馈，开启persistAuthorization: true后，深度链接的自动展开逻辑会被间接触发。即使你的API不需要授权持久化，也可以尝试添加这个配置：

  const ui = SwaggerUIBundle({
    url: "your-swagger-spec.json",
    dom_id: '#swagger-ui',
    deepLinking: true,
    docExpansion: 'none',
    persistAuthorization: true,
    // 其他原有配置
  });
  

• 利用Swagger UI的onComplete钩子处理展开
  通过Swagger UI提供的onComplete回调，在文档加载完成后主动触发目标接口的展开：

  const ui = SwaggerUIBundle({
    url: "your-swagger-spec.json",
    dom_id: '#swagger-ui',
    deepLinking: true,
    docExpansion: 'none',
    onComplete: function() {
      const hash = window.location.hash.slice(1);
      if (hash) {
        ui.expandOperation(hash);
      }
    }
  });
  

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