Android创建凸路径报错：path must be convex问题求助

首先，你遇到的java.lang.IllegalArgumentException: path must be convex异常，核心原因就是你用quadTo()生成的路径不符合凸路径的定义——凸路径要求路径上任意两点的连线都完全落在路径内部，而你的贝塞尔曲线控制点可能导致了路径凹陷，或者路径本身存在其他不符合要求的问题（比如未闭合、顶点顺序混乱）。

我给你拆解一下问题和解决方案：

为什么你的quadTo路径会非凸？ #

用quadTo()时很容易踩坑：如果你的控制点落在路径的"内侧"，生成的二次贝塞尔曲线就会向内凹陷，直接破坏路径的凸性。另外，如果路径没有闭合、顶点绘制顺序乱序（比如一会儿顺时针一会儿逆时针），也会被判定为非凸。

正确构建凸路径的方法 #

1. 先保证基础规则 #

• 路径必须闭合：最后一定要调用path.close()，否则系统会认为路径不完整，大概率判定为非凸。
• 顶点顺序要一致：全程用顺时针或逆时针绘制，不能乱跳，避免路径交叉。
• 控制点要落在路径"外侧"：对于圆角这类常用场景，控制点应该放在角的顶点，这样生成的曲线是向外凸的，不会凹陷。

2. 可直接复用的凸路径示例（带圆角） #

下面是一个用quadTo()生成带圆角的凸路径的完整代码，你可以直接参考：

fun createConvexRoundedPath(viewWidth: Int, viewHeight: Int, cornerRadius: Float): Path {
    val path = Path()
    // 限制圆角半径，避免极端情况（比如半径超过短边一半，虽然胶囊形状也是凸的，但保险起见）
    val safeRadius = min(cornerRadius, min(viewWidth / 2f, viewHeight / 2f))

    // 顺时针绘制，保证顺序一致
    // 从右下角边缘中点开始
    path.moveTo(viewWidth - safeRadius, viewHeight)
    // 右下角圆角：控制点在右下角顶点，曲线向外凸
    path.quadTo(viewWidth, viewHeight, viewWidth, viewHeight - safeRadius)
    // 右边缘直线
    path.lineTo(viewWidth, safeRadius)
    // 右上角圆角
    path.quadTo(viewWidth, 0f, viewWidth - safeRadius, 0f)
    // 上边缘直线
    path.lineTo(safeRadius, 0f)
    // 左上角圆角
    path.quadTo(0f, 0f, 0f, safeRadius)
    // 左边缘直线
    path.lineTo(0f, viewHeight - safeRadius)
    // 左下角圆角
    path.quadTo(0f, viewHeight, safeRadius, viewHeight)
    // 闭合路径，关键！
    path.close()

    // API 21+可调试检查路径是否为凸
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
        println("Path convex status: ${path.isConvex}")
    }
    return path
}

3. 更省心的替代方案 #

如果你不想手动用quadTo()控制凸性，可以直接用系统提供的Path.addRoundRect()方法，它会自动生成符合要求的凸路径（只要圆角半径合理）：

fun createConvexRoundedPathEasy(viewWidth: Int, viewHeight: Int, cornerRadius: Float): Path {
    val path = Path()
    val rect = RectF(0f, 0f, viewWidth.toFloat(), viewHeight.toFloat())
    // 四个角用相同半径，也可以传入float数组指定每个角的半径
    path.addRoundRect(rect, cornerRadius, cornerRadius, Path.Direction.CW)
    return path
}

最后验证和使用 #

把生成的路径传入ViewOutlineProvider时，记得调用outline.setConvexPath(path)，示例：

view.outlineProvider = object : ViewOutlineProvider() {
    override fun getOutline(view: View, outline: Outline) {
        val convexPath = createConvexRoundedPath(view.width, view.height, 16f)
        outline.setConvexPath(convexPath)
        // 设置阴影的 elevation
        outline.elevation = view.elevation
    }
}
// 开启阴影需要设置这个
view.clipToOutline = false

内容的提问来源于stack exchange，提问作者Re'em