Android TextView应用android:textStyle加粗后自定义字体失效问题咨询

你遇到的字体加载失败问题不是自定义字体文件的元数据错误，是Android系统字体加载机制的版本兼容缺陷，加上样式配置存在属性冲突共同导致的。

• 当TextView设置android:textStyle="bold"时，系统会自动触发字重匹配流程：从当前绑定的字体资源集中，查找对应700字重、普通斜体的字体条目完成加载
• 现有配置的两处问题会触发这个bug：
  1. 样式父标签用了原生android:TextAppearance，直接绕过了AppCompat兼容库的字体加载逻辑，走到了原生系统的旧版匹配流程
  2. 样式里同时写了fontFamily（AppCompat支持库属性）和android:fontFamily（系统原生属性）两个指向同一资源的配置，在触发textStyle字重匹配时，系统会出现属性优先级判断错误，直接丢弃自定义字体配置，回退加载系统默认字体
• 布局预览显示正常是因为Android Studio的渲染逻辑用的是新版无bug的字体匹配流程，没有复现低版本运行时的兼容问题。

1. 修正样式的父标签与属性配置
   原样式配置存在冗余和兼容问题：

   <style name="MyText" parent="android:TextAppearance">
       <item name="fontFamily">@font/noto_sans_kr</item>
       <item name="android:fontFamily">@font/noto_sans_kr</item>
   </style>
   

   调整为AppCompat体系下的正确配置，去掉冗余的系统属性引用：

   <style name="MyText" parent="TextAppearance.AppCompat">
       <item name="fontFamily">@font/noto_sans_kr</item>
   </style>
   

2. 校验XML字体集的配置完整性
   现有noto_sans_kr.xml的基础配置是正确的，只要确保两个细节就能稳定匹配字重：
   • 所有<font>标签的属性统一使用app:命名空间，不要混用android:命名空间的字体属性
   • 给每个字体条目显式配置app:fontStyle="normal"，避免系统自动匹配时出现识别偏差
3. 兼容极端场景的fallback方案
   如果需要覆盖到非常低的Android版本，可以在代码层显式指定字重对应的字体，不依赖系统自动的textStyle匹配：

   val boldTypeface = ResourcesCompat.getFont(
       context = this,
       id = R.font.noto_sans_kr,
       fontStyle = FontStyle(FontStyle.FONT_WEIGHT_BOLD, FontStyle.FONT_SLANT_NORMAL),
       handler = null
   )
   targetTextView.typeface = boldTypeface
   

• 直接指定独立的bold字体文件虽然能跑通，但丢失了XML字体集的多字重联动能力，后续动态调整字重、适配多语言字体时灵活性很差
• 这个问题在Android 12以上的原生系统上已经被官方修复，但如果需要兼容API 21+的版本，必须按上述方式修正配置，否则低版本设备上一定会出现自定义字体加载失败的问题

内容的提问来源于stack exchange，提问作者Saehun Sean Oh