Zola 2026-07-30T00:00:00+00:00 https://orhan.cn/tags/api/atom.xml 2026-07-30T00:00:00+00:00 2026-07-30T00:00:00+00:00 menzil https://orhan.cn/posts/rust-partial-update-tristate-seaorm/

<p><code>PATCH /users/{id}</code> 这类部分更新接口里，一个字段通常不只有“有值”和“没值”两种状态。以 <code>name</code> 为例，客户端可能发送：</p> <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{} </span></code></pre> <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{&quot;</span><span style="color:#a3be8c;">name</span><span>&quot;: </span><span style="color:#d08770;">null</span><span>} </span></code></pre> <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{&quot;</span><span style="color:#a3be8c;">name</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">Alice</span><span>&quot;} </span></code></pre> <p>它们的业务含义分别是：不修改 <code>name</code>、将 <code>name</code> 清空为数据库 <code>NULL</code>、将 <code>name</code> 更新为 <code>Alice</code>。</p> <p>问题的核心不是 Rust 有没有 <code>nil</code>，而是 API 输入确实有三种独立语义。把它们明确建模，才能避免把“字段没传”误当成“清空字段”。</p>