5.6 KiB
5.6 KiB
Debug Session: app-map-markers-regression
- Status: [OPEN]
- Created: 2026-09-07
- File Target: pages/user/goods_details_store/index.vue
- Symptom: 打包的 App 端「选择自提门店」页,地图瓦片 + 门店标点(大头针+气泡)都不展示;H5/Dev 端正常。
Hypotheses(可证伪)
| # | 假设 | 预测(插桩后要看到什么) | 关键观察点 |
|---|---|---|---|
| H1 | **Canvas 同时指定了 CSS 类 + inline style 双重定位,App 端 CSS .marker-canvas 的 position:absolute;left:0;top:0;transform:scale(0) 覆盖 inline position:absolute;left:-9999px,导致画布跑到地图左上角可视区 but scale(0) → canvas 尺寸按 CSS 类变成 0×0(因为 CSS class 宽高没写)→ GPU 丢帧/ canvasToTempFilePath 返回空 → commitMarkerResult 写入 fallbackFinal 为 _www/static/icon/map.png(裸相对路径)→ buildMarkers.filter(m=>!!icon) OK 但 plus.map BitmapFactory 解析 _www/static/icon/map.png 失败(之前是靠 copyTo 沙箱 file:// 才成功) → 所有 marker 静默丢弃。 |
DBG_CANVAS_POS:模板 L93 同时有 class="marker-canvas" 和 inline style 重复 position → plus 渲染层 CSS 覆盖 inline,导致 canvas 实际尺寸 0。 |
模板 L93 冲突;renderMarkerIcon successCb resultPath 空,fallbackFinal=_www/static/icon/map.png,buildMarkers 后 markers 数组长度=N 但原生端 render 失败。 |
| H2 | getFallbackStoreIcon 同步路径(L409-L426)所有分支都返回空:冷启动 plus.io.convertLocalFileSystemURL(MARKER_PIN_PNG_WWW) 返回 undefined 或空串 → _cachedFallbackStoreIcon 永远空 → 异步 copyTo(L428+)是 Promise 但 renderMarkerIcon 同步就拿 fallbackIcon = '' → fallbackFinal = getFinalFallback('') = MARKER_PIN_PNG_WWW = '_www/static/icon/map.png' → 与 H1 同终点,BitmapFactory 不认。 |
DBG_FALLBACK_INIT:getFallbackStoreIcon 同步返回 '' / MARKER_PIN_PNG_WWW,非 file:// 开头;copyTo 成功后 buildMarkers 二次触发后仍不生效(因为 tryFixIcon 把 file:// 路径再 normalize 一遍反而丢)。 |
getFallbackStoreIcon() 返回值;copyTo 后 _cachedFallbackStoreIcon 的值;buildMarkers 最终 marker.iconPath 类型。 |
| H3 | buildMarkers 末尾 filter 把所有 marker 都剔了:L777-L780 return !!icon,但 tryFixIcon 在 plus 存在时把所有合法路径都当非法处理返回 safeFallback = MARKER_PIN_PNG_WWW = '_www/static/icon/map.png'(H1/H2),或者 state.markerIconMap[getMarkerKey(id,false)] 在 prepareMarkerIcons 3 并发下被 acquireCanvasLock 超时(4s)强制释放,renderMarkerIcon 抛异常走 top exception 分支写入空串,被 filter 踢。 |
DBG_BUILD_FILTERED:buildMarkers 输入 filteredStoreList.value.length 输出 0;或输出 >0 但每一项 iconPath 都不是 file:// 前缀。 |
buildMarkers 入口 list 长度;map 后中间数组里每项 iconPath 字符串;最终 newMarkers 长度。 |
| H4 | <map> 标签 setting 驼峰没问题,但 plus 引擎在打包 release 构建时 state.mapLatitude / state.mapLongitude 初始值(L134-L135 北京 39.9/116.4)被 tree-shaking 或 Vite 打包时 reactive 内数字丢失(非 0 但 NaN / Infinity)→ 原生地图中心错 + triggerMapRefresh 抖属性失败 → 瓦片白屏 + markers 数组存在但被挪到了无穷远。 |
DBG_MAP_COORDS:onLoad 后 state.mapLatitude/state.mapLongitude/state.mapScale 的类型是 string 或 NaN,triggerMapRefresh state.mapScale = 0 后恢复失败。 |
onLoad 时 state 初始值;triggerMapRefresh 两次 setTimeout 前后值;Number.isNaN / typeof。 |
| H5 | callout.display='BYCLICK' 在打包 App 版旧 plus 引擎上不识别(只认 'ALWAYS'/'NEVER'),L774 设置 BYCLICK → 整个 markers 数组被原生端静默整个丢弃(符合 project_memory 硬约束)。 |
DBG_CALLOUT:改为 'ALWAYS' 或 'NEVER' 后 markers 立刻出。 |
buildMarkers 数组有内容但原生端一个都不画;替换后正常。 |
Instrumentation Plan(不改业务逻辑,仅加 console.warn 前缀 DBG_)
- 模板 L93:确认 canvas class + inline 重复(
.marker-canvas里position:absolute;left:0;top:0;transform:scale(0)vs inlineposition:absolute;left:-9999px)→ 先静态验证 H1(模板里已经写了双重 position:absolute) - buildMarkers(L748-L781):每 10 个店
console.warn('[DBG_BUILD]', {inputLen:list.length, safeFallback, isStatic_safeFallback: isStaticRawPath(safeFallback), newMarkers_len: newMarkers.length, first_3_markers: newMarkers.slice(0,3).map(m=>({id:m.id, iconPathPrefix: (m.iconPath||'').slice(0,20), w:m.width, h:m.height, callout: m.callout?.display}))}) - getFallbackStoreIcon(L408-L492):同步出口 & copyTo 出口各打 1 条:
[DBG_FALLBACK_SYNC] return=${v?.slice?.(0,30)}; [DBG_FALLBACK_COPY] copied=${v?.slice?.(0,50)} - renderMarkerIcon draw 结束:L627 successCb 和 L628 failCb 各 1 条:
[DBG_CANVAS_OK] key=${key} resultLen=${res?.tempFilePath?.length||0}, finalResultAfterResolve=${(resultPath||'').slice(0,40)}; [DBG_CANVAS_FAIL] key=${key} - onLoad 初始 state:L924 try 开头加
[DBG_MAP_INIT] {lat: state.mapLatitude, lon: state.mapLongitude, t_lat: typeof state.mapLatitude, t_lon: typeof state.mapLongitude, nan: Number.isNaN(state.mapLatitude)}
Reproduce Steps(对用户)
- 打 release 包安装冷启动打开「选择自提门店」页;
- 停留 10s 以上,确保 copyTo + prepareMarkerIcons 3 并发全部跑;
- 连上 HBuilderX 控制台 / 或 Android Studio logcat 过滤
[DBG_,把日志贴给我。