Android登录后修改Toolbar用户名触发InflateException报错如何解决

常见根因 #

该异常本质是Toolbar渲染阶段出现不可恢复错误，触发场景集中在异步登录后跨线程操作UI、重复加载Toolbar子View、主题配置冲突三类情况。

可行修复步骤 #

• 强制在主线程更新Toolbar内容
  登录请求的异步回调默认运行在子线程，直接操作Toolbar会触发渲染异常，必须切换到主线程执行UI更新，示例代码：

  // Java示例
  loginResponseCallback(new LoginCallback() {
      @Override
      public void onSuccess(User user) {
          MainActivity.this.runOnUiThread(() -> {
              TextView userNameTv = toolbar.findViewById(R.id.tv_username);
              userNameTv.setText(user.getUserName());
          });
      }
  });
  

  // Kotlin示例
  loginApi.login(req).enqueue(object : Callback<User> {
      override fun onResponse(call: Call<User>, response: Response<User>) {
          runOnUiThread { 
              toolbar.findViewById<TextView>(R.id.tv_username).text = response.body()?.userName 
          }
      }
  })
  

• 固定Toolbar右上角布局，避免运行时重复inflate
  不要在每次登录成功后都动态inflate新的用户名View加到Toolbar上，提前在布局文件中内置右上角用户名控件，仅在需要时更新文本：

  <!-- activity_main.xml 中Toolbar配置示例 -->
  <androidx.appcompat.widget.Toolbar
      android:id="@+id/main_toolbar"
      android:layout_width="match_parent"
      android:layout_height="?attr/actionBarSize"
      app:title="@string/app_name"
      android:theme="@style/Theme.MyApp.Toolbar">
  
      <!-- 提前内置右上角用户名控件 -->
      <TextView
          android:id="@+id/tv_username"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:layout_gravity="end|center_vertical"
          android:paddingHorizontal="16dp"
          android:textSize="14sp"
          android:textColor="@color/white"/>
  
  </androidx.appcompat.widget.Toolbar>
  

• 修正主题配置冲突
  确保宿主Activity使用NoActionBar系列主题，避免系统原生ActionBar和自定义Toolbar同时生效冲突，示例主题配置：

  <!-- res/values/themes.xml -->
  <style name="Theme.MyApp" parent="Theme.MaterialComponents.DayNight.NoActionBar">
      <item name="colorPrimary">@color/purple_500</item>
      <item name="colorPrimaryVariant">@color/purple_700</item>
      <item name="colorOnPrimary">@color/white</item>
  </style>
  
  <style name="Theme.MyApp.Toolbar" parent="Widget.MaterialComponents.Toolbar.Primary">
      <!-- 不要配置Toolbar不支持的属性，直接配置textSize等仅TextView支持的属性会触发渲染错误 -->
  </style>
  

• 避免持有无效Toolbar实例
  如果登录弹窗为独立的DialogFragment，不要直接传递Toolbar实例给弹窗，通过宿主Activity实现回调接口的方式更新Toolbar，避免弹窗持有已销毁的Activity/Toolbar引用导致异常。
• 开启View加载错误堆栈详情
  如果上述方案均无效，在Activity的onCreate方法中添加代码开启ViewInflate的详细报错，定位具体异常属性：

  AppCompatDelegate.setCompatVectorFromResourcesEnabled(true)
  LayoutInflater.from(this).setFactory2 { name, context, attrs ->
      try {
          delegate.createView(name, context, attrs)
      } catch (e: Exception) {
          Log.e("ToolbarInflate", "加载失败控件:$name, 错误原因:${e.message}")
          throw e
      }
  }
  

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