Android PopupWindow 在老年模式下定位偏移问题分析与解决（showAtLocation / 字体缩放 / 抖动）

在 Android 开发中使用 PopupWindow + showAtLocation 做气泡、Tooltip 或菜单时，一个常见但非常隐蔽的问题是：

在系统字体调大（老年模式 / fontScale 增大）后，Popup 会出现位置偏移、抖动，甚至"从顶部滑下来"的视觉现象。

本文记录该问题的完整分析路径与最终稳定解法。

一、问题现象

在以下条件下出现异常：

使用 PopupWindow.showAtLocation()
anchorView 位置计算正确
普通字体模式正常
系统字体调到最大（老年模式）后出现问题：

❗表现

Popup 偏左
Popup 偏下
首次显示时出现"从顶部移动下来"
偶现（不是必现）

二、最初误判（常见思路）

很多人第一反应是：

❌ 误判1：anchor 坐标错误

→ 实际 anchorView 坐标是正确的

❌ 误判2：showAtLocation 计算错误

→ 使用的是标准公式：

text 复制代码

x = anchorX + (anchorWidth - popupWidth) / 2  
y = anchorY - popupHeight - 8dp

仍然偏移

❌ 误判3：measure 不准

尝试：

java 复制代码

contentView.measure(UNSPECIFIED, UNSPECIFIED)

或：

java 复制代码

AT_MOST screenWidth

仍然无效

三、问题真正根因（关键）

该问题本质不是"坐标计算错误"，而是 PopupWindow 的 layout 行为在字体缩放下发生了变化。

3.1 PopupWindow 实际有"两阶段 layout"

text 复制代码

1. measure（开发者参与）
2. WindowManager layout（系统参与）
3. Insets / fontScale 修正
4. 再次 layout（系统行为）

3.2 大字体模式触发 TextView 重排

当 fontScale 增大时：

文本变长
宽度触及上限
触发折行
layout 二次变化

导致：

text 复制代码

measure宽高 ≠ 最终layout宽高

3.3 PopupWindow 存在"隐性宽度约束"

实际最大宽度来自：

Window 可视区域
DecorView padding
background padding
system insets

导致 content 被"强制压缩"

3.4 首帧闪动问题（关键现象）

Popup 显示过程：

text 复制代码

showAtLocation(0,0)
→ 首帧渲染（错误位置）
→ post/update 修正
→ 系统可能再次 layout

因此出现：

❗"从顶部移动下来"的视觉抖动

四、为什么"偶现"

因为 layout pass 的触发时机不稳定：

fontScale 是否触发 reflow
TextView 是否二次 layout
vsync timing
ROM（MIUI / EMUI）差异
Insets 更新延迟

👉 本质是 race condition + double layout

五、核心结论

❗问题不是"计算错"，而是"layout 在你计算之后仍然改变了结果"

六、标准解决方案（工程级）

方案1：show + post + update（基础修复）

java 复制代码

popupWindow.showAtLocation(anchorView, Gravity.NO_GRAVITY, 0, 0);

View contentView = popupWindow.getContentView();

contentView.post(() -> {

    int popupWidth = contentView.getWidth();
    int popupHeight = contentView.getHeight();

    int[] loc = new int[2];
    anchorView.getLocationInWindow(loc);

    int x = loc[0] + (anchorView.getWidth() - popupWidth) / 2;
    int y = loc[1] - popupHeight - dp8;

    popupWindow.update(x, y, -1, -1);
});

方案2：避免首帧闪动（关键优化）

java 复制代码

popupWindow.getContentView().setAlpha(0f);

popupWindow.showAtLocation(anchorView, Gravity.NO_GRAVITY, 0, 0);

popupWindow.getContentView().post(() -> {
    // 计算 + update
    popupWindow.update(x, y, -1, -1);

    popupWindow.getContentView().post(() -> {
        popupWindow.getContentView().setAlpha(1f);
    });
});

👉 核心思想：

❗隐藏错误帧，等 layout 稳定后再显示

方案3：根治方案（推荐）

❗避免 PopupWindow 做精确定位 UI

改用：

FrameLayout overlay
自定义 View 层
自己控制 layout

优点：

不受 Window layout pass 影响
无 flicker
无二次修正
完全可控

七、关键经验总结

✔ 1. measure 不可信

在 fontScale / wrap_content 场景下：

measure ≠ final layout

✔ 2. PopupWindow 会二次 layout

系统可能在 show 后重新计算尺寸

✔ 3. update 不一定是最终结果

update 会被下一次 layout 覆盖

✔ 4. 视觉稳定的关键是"控制首帧"

不是算准，而是不让错的帧显示出来

八、一句话总结

Android PopupWindow 的定位问题，本质不是计算问题，而是 系统 layout 在 show 后仍然变化导致的非确定性渲染问题