tuqin
3 天以前 08fdad8d691b9c68f865b7aee1d62b8a09213656
src/components/map/src/utils.ts
@@ -1,23 +1,26 @@
/**
 * 百度地图 SDK 加载工具
 *
 * 加载地址优先级(按顺序尝试,都失败才报错):
 *   1. /bmap-api/getscript  —— 本站 nginx 反向代理,强制回源百度 IPv4
 *   2. https://api.map.baidu.com/getscript —— 直连百度
 * ⚠️ 本部署环境(含客户端所在网络)IPv6 不通,而百度所有服务域名的 DNS
 * 都优先返回 AAAA(IPv6)记录,浏览器优先连 IPv6 会立即失败——
 * 表现为 script 的 error 事件 1 秒内触发,地图完全加载不出来。
 *   服务器侧实测:curl -4 得到 HTTP 200 / 0.94s;curl -6 直接失败。
 *
 * 为什么要代理(实测结论):
 *   该部署环境(含客户端所在网络)IPv6 不通,而 api.map.baidu.com 的 DNS
 *   优先返回 AAAA(IPv6)记录,浏览器优先连 IPv6 时立即失败——
 *   script 的 error 事件在 1 秒内就触发,根本不是超时。
 *   服务器侧验证:curl -4 得到 HTTP 200 / 0.94s,curl -6 直接失败。
 *   走同域代理后,客户端只访问本机 9023,由服务器用固定 IPv4 回源,
 *   实测 HTTP 200 / 879KB / 0.28s。
 * 因此这里加载的是「本站改写版 SDK」/bmap-sdk.js:
 *   把 SDK 内部所有百度域名(api.map.baidu.com、apimaponline0-3.bdimg.com、
 *   apisv0/1.bdimg.com、webmap0.bdimg.com、map.baidu.com …)
 *   全部替换为 window.location.host + /bmap-xxx,
 *   由服务器 nginx 用固定 IPv4 回源,客户端只访问本站 9023。
 *   (改写脚本生成,见 nginx bmap-proxy.conf 与 public/bmap-sdk.js)
 *
 * 其他踩过的坑:
 *   - 不能用 api?v=1.0&type=webgl(返回 document.write 包装,动态脚本里会被浏览器拦截)
 *   - 加载前要设 window.BMAP_PROTOCOL = 'https'(百度官方要求)
 *   - 不要给 script 加 async(SDK 依赖 document.currentScript 定位自身)
 *   - script 的事件名是 error,不是 onerror
 * 加载顺序:
 *   1. /bmap-sdk.js          —— 本站改写版(瓦片、接口也全部走代理)
 *   2. /bmap-api/getscript   —— 本站未改写代理(兜底)
 *   3. https://api.map.baidu.com/getscript —— 直连百度(IPv6 通的环境可用)
 *
 * 其他注意:加载前要设 window.BMAP_PROTOCOL = 'https';
 * 不要给 script 加 async(SDK 依赖 document.currentScript);
 * script 的事件名是 error 不是 onerror。
 */
// 扩展 Window 接口以包含百度地图 GL API
@@ -41,18 +44,18 @@
    const script = document.createElement('script');
    script.src = url;
    // 注意:不要设 async,SDK 依赖 document.currentScript 定位自身
    // 不要设 async:SDK 依赖 document.currentScript 定位自身
    script.addEventListener('load', () => {
      clearTimeout(timeoutId);
      if (!window.BMapGL) {
        reject(new Error('脚本已下载但未挂载地图对象'));
        reject(new Error(`脚本已下载但未挂载地图对象:${url}`));
        return;
      }
      resolve();
    });
    // 事件名是 error,不是 onerror(写 onerror 永远不会触发)
    // 事件名是 error,不是 onerror
    script.addEventListener('error', () => {
      clearTimeout(timeoutId);
      reject(new Error(`加载失败:${url}`));
@@ -85,26 +88,27 @@
  window.BMapGL_loadScriptTime = Date.now();
  const query = `type=webgl&v=1.0&ak=${accessKey}&services=&t=${Date.now()}`;
  // 优先同域反代(绕过客户端 IPv6 不通),再回退直连
  const candidates = [
    // 本站改写版:内部域名全部指向本站代理,瓦片/接口都走 IPv4
    '/bmap-sdk.js',
    // 本站代理的官方 SDK(未改写,瓦片仍指向百度,仅作兜底)
    `/bmap-api/getscript?${query}`,
    // 直连百度(仅 IPv6 正常的环境有效)
    `https://api.map.baidu.com/getscript?${query}`,
  ];
  loadPromise = (async () => {
    let lastError: any;
    const errors: string[] = [];
    for (const url of candidates) {
      try {
        await loadFrom(url, timeout);
        return;
      } catch (error) {
        lastError = error;
      } catch (error: any) {
        errors.push(error?.message ?? String(error));
      }
    }
    loadPromise = null;
    throw new Error(
      `百度地图 SDK 加载失败(已尝试代理与直连):${lastError?.message ?? ''}`,
    );
    throw new Error(`百度地图 SDK 加载失败:${errors.join(' | ')}`);
  })();
  return loadPromise;