From fc47873ffafb723e539468520b5ba60a058bfb05 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Thu, 18 Jun 2026 16:10:55 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=2018=5F3978=20=E9=87=91?= =?UTF-8?q?=E9=A2=9DString=E5=8C=96=E8=A1=A5=E5=85=85=E8=AF=B4=E6=98=8E?= =?UTF-8?q?=E2=80=94=E2=80=94=E5=89=8D=E7=AB=AF=E6=97=A0=E9=9C=80=E6=94=B9?= =?UTF-8?q?=E5=8A=A8(=E7=B1=BB=E5=9E=8B=E4=BB=8DBigDecimal,=E4=BB=85?= =?UTF-8?q?=E5=BA=8F=E5=88=97=E5=8C=96=E5=8F=A3=E5=BE=84)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit wx 拍板:对齐平台 money=String 约定,字段未改类型,常规渲染/比较/运算无需前端改动。 --- ..._订单与资源v3金额字段补全String序列化-修改接口-管理后台.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/changelogs-v2/2026-06/18_3978_订单与资源v3金额字段补全String序列化-修改接口-管理后台.md b/changelogs-v2/2026-06/18_3978_订单与资源v3金额字段补全String序列化-修改接口-管理后台.md index d9355e8..925ae76 100644 --- a/changelogs-v2/2026-06/18_3978_订单与资源v3金额字段补全String序列化-修改接口-管理后台.md +++ b/changelogs-v2/2026-06/18_3978_订单与资源v3金额字段补全String序列化-修改接口-管理后台.md @@ -12,7 +12,9 @@ 平台铁律「JSON 金额必为 String」此前在 order-v3 / resource 多处 RespVO 漏标 `@JsonSerialize(ToStringSerializer)`，金额被序列化成 JSON number。W1（#3965）已修订单钱 / 状态热区一批，**本批（#3978 共 39 个 VO + #3979 resource RoomTypeVO）经审查全量补齐剩余漏标的金额字段**。 -**这些字段从「数字」变为「带引号字符串」，前端解析金额必须按字符串处理（`new Decimal(str)` / `parseFloat(str)`），勿假设为 number。** 已合并 dev-v3、部署测试服双实例 health UP、9443 + 真 admin token 实测订单详情金额返回字符串通过。 +**字段类型在 Java 内仍是 `BigDecimal`（未改类型），只是 JSON 输出从裸数字变带引号字符串，对齐平台「金额=String」约定。前端无需改动** —— 金额本就按字符串口径处理（W1 #3965 及其它金额接口已是 String），本批把漏标的几个补回一致即可；JS 对金额做 `>` `<` `-` `*` `/` 会自动转数字、照常工作，仅 `a + b` 直接相加（会变字符串拼接）/ 对原始字段 `.toFixed()` / `=== 0`·`!== 0` 严格比较 这三类才需留意，而金额本就不应这样用 → 常规渲染 / 比较 / 运算无需任何改动。 + +已合并 dev-v3、部署测试服双实例 health UP、9443 + 真 admin token 实测订单详情金额返回字符串通过。 注：仅金额字段（金额 / 价 / 费 / 差价 / 成本 / 预算 / 应收实付 / 退款额）；比率字段（profitRate / ratingAvg 等）不受影响。