QML中Behavior绑定number变量报错：期望数值类型

这个问题大概率是属性名冲突导致的——degree这个名称可能和你当前组件上下文里某个内部隐含属性重名了，哪怕你自己声明了property real degree，QML引擎在解析Behavior时还是会误绑定到非数值类型的同名属性上，从而抛出类型不匹配的错误，甚至空的Behavior声明也会触发这个校验错误。

快速解决方法 #

把自定义的degree属性名改成其他名称，比如progressDegree，同时更新所有引用该属性的地方：

// 原错误代码
Item {
    property real degree: 0

    // 注释掉就正常，保留就报错
    Behavior on degree {
        NumberAnimation { duration: 300 }
    }
}

// 修改后正常运行的代码
Item {
    property real progressDegree: 0

    Behavior on progressDegree {
        NumberAnimation { duration: 300 }
    }

    // 环形进度条绘制逻辑里，把所有degree替换为progressDegree
}

其他排查方向 #

• 确认属性声明的正确性：确保你是用property real degree: 0这种方式明确声明的自定义属性，而非继承自父组件的同名属性——如果父组件本身有degree属性且类型不是real，就会导致类型冲突。
• 检查组件上下文：如果你的环形进度条是基于Shape、Path这类图形组件实现的，这类组件可能内部有隐含的degree相关属性，容易和自定义属性重名。

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