ListPreference选择选项时触发异常，如何修复？

这个错误其实说得很直白——你的ListPreference缺少了两个核心配置：用于显示的选项文本数组（entries）和对应的实际值数组（entryValues），这俩是ListPreference正常工作的必填项，缺一个都会触发这个崩溃。

下面分两种常见场景给你修复方案：

1. 通过XML配置（最常用的方式） #

先检查你的偏好设置XML文件（一般在res/xml/目录下，比如preferences.xml），确保ListPreference标签里同时包含android:entries和android:entryValues属性，分别指向strings.xml中定义的字符串数组。

第一步：在res/values/strings.xml里定义两个数组 #

<!-- 显示给用户看的选项文本 -->
<string-array name="operation_mode_entries">
    <item>自动模式</item>
    <item>手动模式</item>
    <item>省电模式</item>
</string-array>

<!-- 对应每个选项的实际值（供代码逻辑使用） -->
<string-array name="operation_mode_values">
    <item>auto</item>
    <item>manual</item>
    <item>power_save</item>
</string-array>

第二步：在偏好XML中关联这两个数组 #

<ListPreference
    android:key="operation_mode"
    android:title="选择运行模式"
    android:summary="设置应用的运行模式"
    <!-- 关联显示文本数组 -->
    android:entries="@array/operation_mode_entries"
    <!-- 关联实际值数组 -->
    android:entryValues="@array/operation_mode_values"
    <!-- 可选：设置默认选中值 -->
    android:defaultValue="auto" />

重点提醒：两个数组的元素数量必须完全一致，否则会出现选项和值不匹配，甚至数组越界的问题。

2. 通过Java代码动态配置 #

如果你的选项是动态生成的（比如从服务器拉取、根据用户权限生成），可以在SettingsActivity的onCreatePreferences方法中手动设置这两个数组：

@Override
public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
    // 加载XML中的偏好配置
    setPreferencesFromResource(R.xml.preferences, rootKey);
    
    // 通过key找到目标ListPreference
    ListPreference modePref = findPreference("operation_mode");
    if (modePref != null) {
        // 动态生成显示文本和对应值的数组
        String[] entries = {"动态选项A", "动态选项B", "动态选项C"};
        String[] entryValues = {"a", "b", "c"};
        
        // 设置到ListPreference中
        modePref.setEntries(entries);
        modePref.setEntryValues(entryValues);
        // 可选：设置默认值
        modePref.setDefaultValue("a");
    }
}

排查小技巧 #

• 检查XML中是否漏写了android:entries或android:entryValues属性
• 确认数组资源的引用有没有拼写错误（比如数组名写错了）
• 确保两个数组的长度完全相同，每个显示文本对应一个实际值
• 如果用动态配置，要保证在ListPreference初始化完成后再设置数组，避免空指针异常

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