radial属性不生效的首要原因是未显式设置android:gradienttype="radial"，系统默认为linear；必须同时配置gradienttype、gradientradius（带单位如100dp）、centerx/centery（比例或带单位值），且radius应不小于宽高较大值的一半以确保兼容性。
radial 属性不生效？先确认 gradientType 是 radial
Android 的 shape 中径向渐变必须显式声明 android:gradientType="radial"，否则即使写了 android:gradientRadius 也完全被忽略——这是最常踩的坑。系统默认是线性渐变（linear），不会报错，但 UI 看不出任何径向效果。
- 必须同时设置：
android:gradientType="radial"+android:gradientRadius -
android:centerX和android:centerY要配合使用，否则渐变中心可能偏出视图范围 - 如果父容器尺寸不固定（比如
wrap_content），android:gradientRadius建议用带单位的值（如120dp），避免依赖测量结果导致半径过小或溢出
gradientRadius 单位和取值逻辑很关键
android:gradientRadius 的值不是“像素半径”，而是从中心点到渐变结束边缘的距离，单位必须明确（dp 最常用）。它不接受纯数字（即无单位），否则在某些 Android 版本会静默失效或渲染异常。
- 写成
android:gradientRadius="100"❌：编译通过但实际无效（尤其在 Android 8.0+） - 正确写法：
android:gradientRadius="100dp"✅ - 若想按视图宽高比例动态适配，不能直接写百分比；得用代码创建
GradientDrawable并调用setGradientRadius() - 过大的半径（比如
500dp）可能导致边缘颜色过渡极淡，视觉上像没渐变
XML 中无法指定径向渐变的“焦点偏移”
Android 原生 XML shape 不支持类似 CSS radial-gradient(at 30% 40%, ...) 那样的焦点偏移语法。你只能靠 android:centerX 和 android:centerY 定位圆心，且这两个值是相对整个 shape 尺寸的比例（0.0–1.0）或绝对尺寸（带单位）。
- 写
android:centerX="0.3"表示水平方向 30% 处，前提是该值是浮点数且无单位 - 写
android:centerX="60dp"表示距左边缘 60dp，此时 shape 必须有明确宽高（如作为background时父 View 不能是wrap_content） - 混用单位和比例会出错：比如
centerX="0.3dp"❌，系统无法解析
API 23+ 有兼容性细节要注意
在 Android 6.0（API 23）及以上，如果 gradientRadius 设得比 shape 实际可绘制区域还小，系统可能裁剪掉部分渐变，导致颜色突然截断。这不是 bug，而是光栅化策略变化。
- 安全做法：把
gradientRadius设为至少等于 shape 宽高较大值的一半（例如宽 200dp、高 120dp，半径至少设100dp） - 调试技巧：临时加一层
stroke或用不同背景色对比，确认 shape 实际渲染尺寸是否符合预期 - 真机上发现渐变“不圆”？大概率是
centerX/centerY没对齐，或者父布局用了scaleX/scaleY变形
