Android Kotlin Fragment中指南针报NullPointerException：getDefaultSensor返回null

问题根源 #

你遇到的空指针异常，核心原因是部分设备没有内置磁力计（Sensor.TYPE_MAGNETIC_FIELD）传感器，调用sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD)会返回null，后续直接使用这个空对象就会触发崩溃。

解决方案 #

1. 先校验传感器是否存在，再执行逻辑

在获取磁力计传感器后，必须先判断是否为null，避免直接调用相关方法：

// 在onViewCreated中获取SensorManager后
Sensor magneticSensor = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD);
Sensor accelerometerSensor = sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);

// 指南针需要加速度传感器+磁力计，需同时校验
if (magneticSensor == null || accelerometerSensor == null) {
    // 给用户提示或做降级处理
    if (getContext() != null) {
        Toast.makeText(getContext(), "当前设备不支持指南针功能", Toast.LENGTH_SHORT).show();
    }
    return;
}

// 确认传感器存在后，再注册监听
sensorManager.registerListener(this, magneticSensor, SensorManager.SENSOR_DELAY_NORMAL);
sensorManager.registerListener(this, accelerometerSensor, SensorManager.SENSOR_DELAY_NORMAL);

2. 在Manifest中声明传感器特性，过滤不支持的设备

在AndroidManifest.xml中添加配置，让Google Play自动过滤掉没有磁力计的设备：

<!-- 如果指南针是核心功能，设为true，无传感器的设备无法下载 -->
<uses-feature android:name="android.hardware.sensor.compass" android:required="true" />

<!-- 如果只是可选功能，设为false，仍允许下载，但代码里必须做传感器存在性判断 -->
<!-- <uses-feature android:name="android.hardware.sensor.compass" android:required="false" /> -->

3. 规范Fragment生命周期内的传感器管理

在Fragment的生命周期方法中及时注销传感器监听，避免内存泄漏同时减少异常场景：

@Override
public void onPause() {
    super.onPause();
    if (sensorManager != null) {
        sensorManager.unregisterListener(this);
    }
}

@Override
public void onDestroyView() {
    super.onDestroyView();
    sensorManager = null; // 置空SensorManager，避免内存泄漏
}

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