25、常见问题排查：传感器不工作、数据异常、不同品牌兼容性问题、日志分析技巧

距离传感器这东西，平时安安静静地工作，你几乎感觉不到它的存在。但一旦出问题，那就是灾难——打电话不熄屏、靠近耳朵黑屏后死活不亮、或者数据乱跳。我这些年排查过的传感器问题，少说也有上百例了。今天就把最常见的坑和排查思路，一次性说清楚。

25.1 传感器完全不工作

先别急着怀疑硬件坏了。我遇到过好几次，折腾半天发现是驱动没加载。

第一步：确认设备节点是否存在

adb shell ls -l /sys/class/sensors/proximity_sensor/
# 或者
adb shell cat /sys/class/sensors/proximity_sensor/name

如果返回 No such file or directory，说明驱动层就没起来。这时候查 dmesg：

adb shell dmesg | grep -i proximity

常见原因：

• GPIO 配置错误，I2C 地址不对
• 电源域没打开，传感器没供电
• 中断引脚被其他设备占用了

第二步：检查 HAL 层是否注册

adb shell dumpsys sensorservice | grep -i proximity

如果看不到 sensor 列表，说明 HAL 没加载。常见原因是 android.hardware.sensor.proximity 这个 feature flag 没在 framework/native/data/etc/ 里声明。

25.2 数据异常：跳变、卡死、数值不对

传感器能工作，但数据不对，这种问题更隐蔽。我把它分成三类：

数据跳变的典型案例：

我记得有一次，某款手机在打电话时屏幕忽亮忽灭。抓 log 一看，距离值在 0 和 2 之间来回跳。原因是传感器玻璃盖板太薄，红外光从内部反射回来了。解决方案是调整驱动里的 cross_talk 补偿参数。

25.3 不同品牌兼容性问题

这是最让人头疼的部分。同一个 APK，在小米上正常，在 OPPO 上就失灵。为什么？

原因一：各家的校准数据不通用

每台手机出厂时都会做距离传感器校准，校准值存在 /persist/sensors/ 或 /mnt/vendor/persist/ 分区里。不同品牌的校准算法不同，导致同一颗 sensor 在不同手机上表现不一样。

原因二：上报频率和精度差异

Android 官方要求距离传感器至少支持 SENSOR_DELAY_NORMAL（200ms），但有些厂商只实现了这个最低标准。你的 App 如果用了 SENSOR_DELAY_FASTEST，在部分手机上可能拿不到数据。

原因三：虚拟传感器 vs 物理传感器

有些手机（尤其是折叠屏）用的是虚拟距离传感器——通过屏幕接近感应 + 超声波混合计算。这类传感器在 API 层面表现正常，但底层行为完全不同。

25.4 日志分析技巧

排查传感器问题，log 是唯一的真相。但 log 量很大，怎么快速定位？

抓取关键 log 的命令：

# 实时抓取传感器事件
adb logcat -s Sensors

# 抓取驱动层日志
adb shell dmesg -w | grep -E "proximity|sensor|i2c"

# 抓取 HAL 层日志
adb logcat -b all | grep -i "proximity\|sensor_service"

# 查看传感器数据流
adb shell getevent -l | grep -i proximity

日志分析三步法：

1. 看时间戳——数据上报间隔是否稳定？如果忽快忽慢，说明调度有问题。
2. 看数值范围——正常距离传感器返回值是 0（靠近）和 5（远离），如果出现负数或超大值，说明驱动层数据没处理好。
3. 看错误码——常见的有 -EIO（I2C 通信失败）、-ENODEV（设备未找到）、-ETIMEDOUT（超时）。

25.5 知识体系总览

下面这张图，把距离传感器常见问题的排查路径串起来了。你可以把它当成一张「故障地图」——从现象出发，沿着箭头找到根因。

这张图的核心逻辑是：先判断是「完全不工作」还是「数据异常」，然后沿着对应分支往下查。如果两个分支都查不出问题，那就要考虑品牌兼容性了——比如某款手机对特定 sensor 做了特殊处理。

好了，关于距离传感器的常见问题排查，就聊到这里。实际工作中，你可能会遇到更奇葩的问题——比如传感器在低温下失灵、贴了钢化膜后数值漂移、甚至某些 App 抢占了 sensor 独占权限。但万变不离其宗，掌握了我上面说的排查思路和日志技巧，大部分问题都能在半小时内定位。