Odoo的后台界面大量依赖jQuery UI组件，其中数量、金额输入框常用Spinner控件提供上下箭头微调功能。不少开发者反馈，在采购单、销售单中反复点击箭头后，金额会悄悄偏离正确值，例如从10.10变成10.099999999999998，财务对账时才发现问题。这类误差的源头并不是Odoo的业务逻辑，而是JavaScript浮点数运算与Spinner默认步进方式叠加的结果。本文将分析误差产生的原因，并给出在自定义模块和标准表单中都能落地的修复方案。
一、误差从哪里来：浮点数存储与Spinner的默认行为
JavaScript中所有数字统一采用IEEE 754双精度浮点表示，0.1和0.2这类十进制小数在二进制中都是无限循环的，只能近似存储。执行0.1加0.2时，结果是0.30000000000000004，这是语言层面的固有行为，任何浏览器都无法避免。
jQuery UI Spinner在源码中处理step时，会先把当前值parseFloat，再累加步长，最后直接输出。也就是说，每一次点击箭头都在做一次浮点加法，误差会随点击次数不断累积。默认step为1时问题不明显，一旦业务上把step设置为0.01（金额场景最常见），误差就开始出现了。
// 默认行为演示：点击箭头20次后的值
var value = 10.10;
var step = 0.01;
for (var i = 0; i < 20; i++) {
value = parseFloat(value) + step;
}
console.log(value); // 10.299999999999997 而不是 10.30Odoo的ORM层本身对货币字段有精度控制，依赖decimal_precision配置，通常金额保留2位小数，但前端输入框中的值如果带着一长串小数位被提交，write时会经历一次四舍五入，多次往返后舍入方向不一致，最终就产生了肉眼可见的金额偏差。
二、修复方案一：以最小货币单位整数做运算
最稳妥的思路是不让浮点数参与加减。把金额乘以100转换成以分为单位的整数，所有步进都在整数域完成，最后再除回并格式化输出。整数运算在浮点表示中是精确的，只要数值不超过2的53次方，就不会有任何误差。
如果Spinner是自己初始化的，比如自定义模块中的widget，可以直接在options里重写step，并用自定义的parse和format钩子控制输入输出：
// 以分为单位做步进，彻底绕开浮点累加
$("#amount_spinner").spinner({
step: 1, // 内部按分步进
min: 0,
max: 10000000,
numberFormat: "n",
parse: function (val) {
// 输入时把显示值（元）转成内部值（分）
return Math.round(parseFloat(val) * 100);
},
format: function (val) {
// 输出时把内部值（分）格式化为元，保留两位小数
return (val / 100).toFixed(2);
},
spin: function (event, ui) {
// 强制对齐到分，防止极端情况下越界
return Math.round(ui.value);
}
});这种做法的好处是逻辑完全收在前端，不依赖任何外部库。需要注意的是min和max也要按分来设置，例如金额上限10万元对应1000000分。如果业务涉及四位小数的价格单位，把100换成10000即可，原则是让内部运算全部落在整数域。
三、修复方案二：保留浮点运算但每次步进后归位
有些场景下无法改变内部值的量纲，比如Odoo标准表单中的输入控件直接挂载了Spinner，值绑定的是字段本身。这种情况下可以采用另一种策略：每次spin事件触发后，立即把结果四舍五入到目标小数位，把误差在每一步清零，不让它累积。
// 在spin回调中立即归位，阻断误差累积
$spinner.on("spin", function (event, ui) {
var fixed = Number(Math.round(ui.value + 'e2') + 'e-2');
$(this).spinner("value", fixed);
event.preventDefault(); // 阻止默认赋值，改用归位后的值
});
// 更通用的精确舍入函数
function roundTo(value, decimals) {
var factor = Math.pow(10, decimals);
return Math.round(value * factor) / factor;
}这里有个细节：直接用toFixed做舍入在部分边界值上会遵循二进制舍入规则，结果反而不符合财务习惯。写法Number(Math.round(x + 'e2') + 'e-2')借道字符串，让舍入发生在十进制域，是社区公认比较可靠的方案。无论采用哪种写法，关键点只有一个：误差必须立即清除，绝不能带着误差进入下一次运算。
四、在Odoo模块中落地与兜底校验
在前端组件层面，可以扩展Odoo的数值字段，在写入字段前做一次归位处理。核心是拦截值变更回调，在调用setValue之前把原始值修正为两位小数：
// 扩展数值字段，写入前强制两位小数归位
var registry = require('web.field_registry');
var basicFields = require('web.basic_fields');
var InputField = basicFields.InputField;
var PrecisionField = InputField.extend({
_onSpinnerValueChanged: function () {
if (this.mode === 'edit') {
var raw = this.$input.spinner("value") || 0;
var fixed = Number(Math.round(raw + 'e2') + 'e-2');
this._setValue(String(fixed));
} else {
this._super.apply(this, arguments);
}
},
});
registry.add('precision_spinner', PrecisionField);前端修复之外，建议在模型层加一道兜底。用@api.constrains或在write重写中对金额字段做校验，即使前端出现漏网的精度问题，落库前也会被纠正。Python端务必使用round(value, 2)处理浮点，或者直接使用fields.Monetary让Odoo按货币精度自动处理，示例如下：
from odoo import models, fields, api
class SaleOrderLine(models.Model):
_inherit = 'sale.order.line'
@api.constrains('price_unit')
def _check_price_unit_precision(self):
for line in self:
# 落库前兜底，纠正前端可能带来的精度漂移
correct = round(line.price_unit, 2)
if correct != line.price_unit:
line.price_unit = correct最后补充一个排查技巧：如果页面上的金额已经显示异常，先确认数据是展示层问题还是存储层问题。在浏览器控制台调用read接口，对比后端返回的原始值，如果后端返回正常而页面异常，问题在前端格式化；如果后端本身已错，需要从ORM写入路径回溯。分清这两类情况，可以少走很多弯路。通过整数化运算、逐步归位和后端兜底三层防护，Spinner带来的金额误差可以被彻底消除。
OdoojQuery UI Spinner浮点精度修改时间：2026-09-05 04:56:47