
本文详解因 recyclerview adapter 未正确初始化导致的空指针异常(nullpointerexception),通过修正成员变量赋值错误,确保 `notifyiteminserted()` 安全调用,使新增联系人功能稳定运行。
在 Android 开发中,使用 RecyclerView 展示联系人列表时,若点击“添加”按钮后应用闪退并报错 java.lang.NullPointerException: Attempt to invoke virtual method 'void com.example.recycleview.RecyclerContactAdapter.notifyItemInserted(int)' on a null object reference,根本原因在于 Adapter 成员变量未被正确初始化——即声明了类级 adapter 字段,却在 onCreate() 中创建了一个同名的局部变量,导致成员变量始终为 null。
? 问题定位:成员变量 vs 局部变量
你的代码中存在典型的变量作用域混淆:
public class MainActivity extends AppCompatActivity {
ArrayList arrContact = new ArrayList<>();
RecyclerContactAdapter adapter; // ✅ 成员变量(初始值为 null)
RecyclerView recyclerView;
FloatingActionButton btnOpndlg;
@Override
protected void onCreate(Bundle savedInstanceState) {
// ... 省略部分代码 ...
// ❌ 错误写法:这里声明的是新局部变量,覆盖了成员变量
RecyclerContactAdapter adapter = new RecyclerContactAdapter(this, arrContact);
recyclerView.setAdapter(adapter);
// 后续在 Dialog 的 onClick 中调用 adapter.notifyItemInserted(...)
// → 实际调用的是上面未赋值的成员变量 adapter(仍为 null)→ 崩溃!
}
} ✅ 正确修复:统一赋值给成员变量
只需移除局部变量声明中的类型关键字 RecyclerContactAdapter,直接赋值给已声明的成员变量:
// ✅ 正确写法:将 adapter 实例赋值给类成员变量 adapter = new RecyclerContactAdapter(this, arrContact); recyclerView.setAdapter(adapter);
同时,建议在设置 Adapter 前确保 recyclerView 已完成初始化(你已正确调用 findViewById),并补充空值防护(增强健壮性):
if (adapter == null) {
adapter = new RecyclerContactAdapter(this, arrContact);
recyclerView.setAdapter(adapter);
} else {
adapter.notifyDataSetChanged(); // 或根据需求刷新
}? 补充优化建议
-
输入校验逻辑需完善:当前代码中,当姓名或号码为空时仅弹 Toast,但依然会执行 arrContact.add(...)(使用默认空字符串 " ")。应改为 仅在两项均非空时才添加数据:
String name = edtname.getText().toString().trim(); String number = edtno.getText().toString().trim(); if (name.isEmpty()) { Toast.makeText(MainActivity.this, "请输入姓名", Toast.LENGTH_SHORT).show(); return; } if (number.isEmpty()) { Toast.makeText(MainActivity.this, "请输入电话号码", Toast.LENGTH_SHORT).show(); return; } arrContact.add(new ContactModel(R.drawable.ic_contact, name, number)); // 注意:图标资源建议传具体 ID 或统一占位图 adapter.notifyItemInserted(arrContact.size() - 1); recyclerView.smoothScrollToPosition(arrContact.size() - 1); dialog.dismiss(); 避免重复添加相同测试数据:初始化列表时多次添加相同联系人(如多个 "mob"),虽不影响崩溃修复,但不利于调试。建议使用唯一标识或简化初始数据。
使用 ViewBinding(推荐升级):替代 findViewById,提升类型安全与性能(非必须,但属现代实践)。
? 总结
- ✅ 核心修复:adapter = new RecyclerContactAdapter(...) —— 确保成员变量被赋值;
- ✅ 安全调用:adapter 非空后,notifyItemInserted() 和 scrollToPosition() 才可安全执行;
- ✅ 用户体验:完善表单验证逻辑,防止无效数据插入;
- ✅ 可维护性:避免局部/成员变量命名冲突,必要时启用 Lint 检查。
完成上述修改后,点击添加按钮即可动态插入新联系人,RecyclerView 将平滑更新且应用不再崩溃。










