Android调用ConstraintLayout.findViewById触发空指针异常排查

报错信息 #

Caused by: java.lang.NullPointerException: Attempt to invoke virtual method 'android.view.View androidx.constraintlayout.widget.ConstraintLayout.findViewById(int)' on a null object reference

报错最初定位到代码行：LinearLayout all_sets = main.findViewById(R.id.all_sets);

根本原因 #

这个空指针和布局嵌套层级没有任何关系，是两个基础用法错误导致的：

• setContentView()调用顺序完全颠倒。你把加载布局的代码写在了所有findViewById()操作的最后。findViewById()的逻辑是从当前Activity已经挂载的视图树里匹配对应ID的控件，没调用setContentView(R.layout.activity_main)之前，Activity根本没加载任何视图，所有找控件的操作返回值都是null，对null对象调用方法必然触发空指针。
• 根布局获取方式完全错误。你写的ConstraintLayout main = findViewById(R.layout.activity_main);是典型的API误用：findViewById()只能接收视图ID参数，也就是R.id.xxx格式的值，R.layout.activity_main是布局文件本身的资源标识，不是控件ID，就算加@SuppressLint("ResourceType")压掉编译警告，运行时也找不到对应控件，main变量本身就是null，调用main.findViewById()直接抛错。

你后面尝试去掉main变量直接调用findViewById(R.id.all_sets)还是报错，本质还是顺序问题：那时候还没加载布局，all_sets拿到的是null，再调用all_sets.findViewById()自然继续报空指针。

初始隐藏控件的实现方案 #

要做到布局正式展示前就把指定ImageView设为不可见，只要修正代码顺序和用法就行。onCreate生命周期里，setContentView执行完到页面首次绘制上屏之间的所有控件操作，都不会被用户看到，完全不会出现控件先显示再消失的闪烁问题。

修正后的可运行代码 #

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 所有findViewById操作必须放在setContentView之后，这是*硬性顺序要求*
    setContentView(R.layout.activity_main);

    // 直接通过ID找控件就行，不需要强制从父View链式调用，只要ID不重复就能正常获取
    LinearLayout all_sets = findViewById(R.id.all_sets);
    LinearLayout set1 = findViewById(R.id.set1);
    LinearLayout set2 = findViewById(R.id.set2);
    LinearLayout set3 = findViewById(R.id.set3);

    ImageView triangle1 = findViewById(R.id.triangle1);
    ImageView triangle2 = findViewById(R.id.triangle2);
    ImageView cloud = findViewById(R.id.cloud);
    ImageView hexagon = findViewById(R.id.hexagon);

    // 设置不可见状态，这时候布局还没渲染到屏幕，用户看不到控件的初始可见状态
    triangle1.setVisibility(View.INVISIBLE);
    triangle2.setVisibility(View.INVISIBLE);
    cloud.setVisibility(View.INVISIBLE);
    hexagon.setVisibility(View.INVISIBLE);
}

可选优化 #

• 如果需要获取根ConstraintLayout，给XML里的根布局加个ID就行，比如加android:id="@+id/main_root"，之后用findViewById(R.id.main_root)获取，绝对不能把R.layout类的资源ID传给findViewById。
• 如果项目用了AppCompatActivity，完全可以直接在XML布局里给需要初始隐藏的ImageView加android:visibility="invisible"属性，不需要写Java代码设置，效果完全一样。
• 不需要加任何布局加载监听、不需要延迟执行，setContentView执行完之后视图树就已经完成加载，此时操作控件是Android的标准写法，没有时序问题。

内容的提问来源于stack exchange，提问作者An Alt Of A User Who Has Alts