# android.view.InflateException: 二进制XML文件第#XX行：膨胀类androidx.constraintlayout.widget.ConstraintLayout时出错

- **ID:** `android/layout-inflate-error-constraintlayout`
- **领域:** android
- **类别:** runtime_error
- **验证级别:** ai_generated
- **修复率:** 88%

## 根因

ConstraintLayout版本不匹配或build.gradle中缺少依赖项，导致运行时布局膨胀失败。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| ConstraintLayout 2.1.4 | active | — | — |
| Android Gradle Plugin 8.0.0 | active | — | — |
| AndroidX AppCompat 1.6.0 | active | — | — |

## 解决方案

1. ```
   Add explicit ConstraintLayout dependency in build.gradle: implementation 'androidx.constraintlayout:constraintlayout:2.1.4' and ensure all AndroidX libraries are on same version.
   ```
2. ```
   Downgrade ConstraintLayout to 2.1.3 if using older AGP version, or upgrade AGP to 8.1.0 for compatibility.
   ```

## 无效尝试

- **Adding ConstraintLayout dependency without specifying version, relying on transitive dependency from AppCompat** — Transitive version may be outdated or incompatible with other libraries; explicit version needed. (65% 失败率)
- **Cleaning project and rebuilding without updating dependencies** — Does not address version mismatch; if dependencies are stale, rebuild repeats same error. (50% 失败率)