Files
jinzuanwork/backend/backend-site/回执-Claude.md
T
ywsandClaude Opus 5.5 651d21d882 fix(backend): 复查修复(一码两单 / 回调重放 / 跨进程覆盖 / sweep 误删 等)+ 回执
- submit/activate:查码与绑码同锁(redeem_bind),防并发一码两单
- submit:卡密规则按 max(前端 nTotal, 实际模板数) 与模板并集校验;拒未知模板
- 爱发电回调:发码或激活过一律幂等原样回;回调与账本读写串行(HOOK_LOCK)
- LOCK 加跨进程 flock;jsave 唯一临时文件 + fsync + 沿用权限
- admin.py sweep 不删 waiting/working/paid;retry 加锁
- 卡密/订单号/取件码改用 secrets
- redo 换皮肤走 PNG 核验;feedback 限频 + 磁盘闸 + 只收图片
- 下载/取皮肤边读边发;zip 成品 STORED + 同时只打一个包
- H.finish 与 socketserver.finish 重名 → 改名 finish_upload(路径不变)
- 部分失败:记 plan_total/partial,通知金钻,页面说实话
- /claim 新增 terms_v 字段(只增,渲染机无需改)
- ys_local.py:只接受本机页面的 POST(Host/Origin 校验)
- 两份 回执-Claude.md + tests/回执复现测试.py(原版 13/27 失败,改后全过)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 12:14:02 +00:00

33 KiB
Raw Blame History

回执 · Claude(受 ywsabc2 委托)· 2026-10-05

范围:backend-site/(server.py / admin.py / pngcheck.py)+ deploy/nginx-片段.md,以及它和前端 order/index.html 的对接。 渲染机 / 本机工具那边单独一份:backend-tools/回执-Claude.md。 行号一律指交付时的原版(提交 c6034e9)。 我改过的地方都在 server.py / admin.py 里标了「2026-10-05(外部复查)」,搜这几个字就能全部找到。


0. 一句话总结

整体思路是对的(无人值守、渲染机只出站、收钱以服务器为准、话术不骗人),工程习惯也好(决定留痕、踩坑写进注释)。 最该先修的是「钱」和「数据」上的并发 / 信任问题:一码两单、前端报的张数被直接信、支付回调重放白送码、 CLI 和服务器互相覆盖 codes.json、sweep 会删掉还在排队的已付款单。 这些我都已经改了,并且写了复现测试:同一套 27 条用例,原版失败 13 条、改后全部通过(见第 3 节末尾)。 接口路径一条没动;接口字段只新增了一个(/claim 返回里的 terms_v),渲染机那边不用改代码。


1. 问题分析

🔴 = 会丢钱 / 丢数据 / 能被人利用;🟡 = 静默失败、显示骗人、能把机器拖死;🟢 = 小问题 / 坏味道。 「已修」= 这次直接改了;「建议」= 只给意见没动(多半是要你们拍板,或者动的是部署层)。

# 严重度 位置(原版) 问题是什么 触发条件 影响 状态
1 🔴 server.py submit 1626 查码 → 1741 绑码 「查码」和「绑码」在两次加锁里,中间隔着 base64 解码、PNG 核验、落盘 同一张码同时提交两次(连点、两个标签页、脚本) 一码两单。实测:并发 6 次成了 2 单 已修
2 🔴 server.py submit 1635-1637 卡密规则用的张数 / 模板并集是前端报的 nTotal / tplUnion,真提交的 templates 不受它约束 「固定 1 张」的码 + templates 塞 7 个 + nTotal=1;锁模板的码 + tplUnion=锁定那组 + templates=别的 花 1 张的钱出 7 张;锁模板(试玩券)形同虚设。实测两条都能过 已修
3 🔴 server.py payplatform_hook 2014 幂等只认「发过码」。「对上网页单并激活」那条路记的是 code=None 同一笔单再推一次:爱发电自己会重试;这个地址又是公开的,谁都能把报文原样再 POST 一次 第二次激活失败(单子已在排队)→ 掉进「按买码处理」→ 白送一张码,还写在返回体里。实测:重放一次多出 1 张码 已修
4 🔴 server.py LOCK = threading.Lock() 151;admin.py 各命令 锁只管本进程的线程。admin.py 是另一个进程,同样读-改-写 codes.json / meta.json CLI 发码 / 改码 / retry 的同时,网页上有人下单 互相覆盖。实测:CLI 发 200 张,最后文件里只剩 15 张;还有已下单的码被改回「可用」 已修
5 🔴 admin.py cmd_sweep 279 + server.py expire_at 没开放下载的单,到期按「创建 + 72h」算,不看状态 渲染机关了三天(出差、断网、坏了),或者买家报了付款、金钻还没确认 排队中 / 待确认的单被整目录删掉,码还被记成「已核销」:钱收了、皮肤没了、图也没出。实测:5 天前的排队单被删 已修(只跳过 waiting/working/paid,见第 2 节 #5 的取舍)
6 🔴 server.py new_oid 713 / new_owner_token / gen_codes 742 / 批次号 / 反馈号 卡密、订单号、取件码都用 random(梅森旋转,不是密码学随机) 攻击者攒够输出(反复领福利券、反复下网页单都会拿到码和取件码)就能还原内部状态 能预测之后要生成的卡密和别人的取件码。7.9e17 的码空间只防「盲猜」,防不住「预测」 已修(换 secrets,格式不变)
7 🔴 server.py redo 2340 重渲换皮肤:只 base64 解一下、看大小就落盘,没走 PNG 结构核验 任何拿着自己取件码的人 「夹带私货」防护整个绕过,而且这个文件会直接发到家里那台电脑上给 Blender 读。实测:尾部夹带 18 字节照样落盘 已修
8 🟡 server.py feedback 2413 不限频、不看磁盘;每条能存一张 4MB 的「图」(不校验是不是图),还往 calls.jsonl 写一条「呼叫」 写个循环 把盘写满(盘满后所有 jsave 都会失败);金钻手机通知被刷爆 已修
9 🟡 server.py download 2559 下载原图是 f.read() 整张读进内存 4096 的无压缩 16bit 一张几十 MB,几个人同时下 服务 MemoryMax=256M,会被 OOM 整个杀掉(你们说这是最值得报的一类) 已修(边读边发,和 zip 一样)
10 🟡 server.py class H 里的 def finish 2694 和 socketserver 的 StreamRequestHandler.finish() 重名。框架在每个请求处理完都调一次 self.finish() 任何请求 每个请求结束后都把「回传成品」再跑一遍:多写一个 403;带渲染机令牌的请求还会再去读一次请求体(读到连接关闭才返回)。日志里大量「Exception occurred during processing of request … in finish」就是它(测试里原版一轮 32 条,改后 0 条) 已修(方法改名,路径不变)
11 🟡 server.py finish 2754 / 2764;order_detail 1802-1808 渲染机收单(close)不带 total,服务器退回按「模板数」算;渲染机的 total 是按文件数(每模板 2 张)报的。另外部分失败照样标「已完成」,原因只写进 note,而 done 状态的页面文案会把 note 盖掉 有模板渲失败、或回传失败(见渲染机回执里的 16MB 上限问题) 静默少交货:买家看到「渲染完成」,金钻也收不到任何提醒 已修(见第 3 节)
12 🟡 server.py activate 2229-2282 同 #1:查码和绑码不在同一把锁里;而且输错码不计数 同一张码同时激活两张网页单;拿这个接口试码不触发冷却 一码两单;试码没有冷却 已修
13 🟡 server.py edit_code 1253(锁外读、锁里写)、gift_batch_add 464-467(锁外读写) 读-改-写不在同一把锁里 面板改码 / 补福利券的同时有人下单或领券 存回去的旧快照把别人刚改的码冲掉(码被改回「可用」= 一码两用) 已修
14 🟡 server.py jsave 655 临时文件名固定是 path + ".tmp";写完不 fsync 两个线程 / 进程同时写同一个文件;或者写完马上断电 互相截断出半截 JSON;断电后可能留一个 0 字节的 codes.json(jload 读坏了会静默当成空字典 → 整个码池「消失」) 已修
15 🟡 deploy/nginx-片段.md /order/api/submit 的 client_max_body_size 4m,但后端和页面都说皮肤最大 10MB(base64 后约 13.4MB);add-skin / redo / feedback 走通用 location,没配大小 = nginx 默认 1MB 买家传一张 3MB 以上的皮肤;追补 / 重渲换一张 700KB 以上的皮肤;反馈带一张截图 nginx 直接回 413 的 HTML,前端 r.json() 解析失败 → 买家只看到一句笼统的失败,不知道是图太大 建议(部署层,见第 2 节;如果你们线上的值和片段一样的话)
16 🟡 server.py ip_of + admin_ip_ok 708 管理接口的 IP 门靠 X-Real-IP;取不到就用连接来源 —— 经过 nginx 时连接来源永远是回环,而回环在白名单里。原版白名单里还有 "?" 哪天某条 location 漏配 proxy_set_header X-Real-IP 来源变成回环 → IP 这道门对公网失效,只剩令牌一道 "?" 已去掉;其余建议(第 2 节)
17 🟡 server.py order_detail 1793 文案里写了 Markdown 的 **已经付过款,不用再付款**,页面当纯文本显示 每一张卡密单 买家看到两对星号(我在浏览器里端到端点了一遍看到的) 已修
18 🟡 order/index.html 条款全文 vs server.py TERMS_VERSION 页面上条款全文标的是「版本 2026-10-01.1」,提交时记进订单的是 2026-10-04.1 每一单 「订单里记版本号,日后争议时证明买家当时同意的是哪一版」—— 现在记的版本和买家看到的那份对不上 没动:不知道是只改了版本号、还是条款内容也改了,要你们定
19 🟡 server.py claim 2606 + ys_worker.py 26 / 438 派单不带订单的条款版本,渲染机留档时只能用自己写死的 2026-10-01.1 每一单 永久留档里的「条款版本」全是错的 已修(/claim 新增 terms_v,渲染机本来就先读它,不用改)
20 🟡 server.py download_zip 2879 PNG 再 ZIP_DEFLATED 一遍几乎不变小、白烧 CPU;不限并发,每个包最大 600MB 临时文件 同一个取件码连点 / 并发几次 盘和 CPU 一起被占满 已修(成品 STORED + 同时只打一个包)
21 🟢 server.py my_coupons 2462 / coupon_status 一次查 60 张券 = 读 60 遍 codes.json;不限频 刷这个接口 CPU;另外它和 /api/code/<码> 都能当「码是否存在」的查询口子,不计输错 读文件次数已修;查询口子在换成 secrets 之后风险可以忽略
22 🟢 server.py activate_payplatform 2176 按「订单号后缀匹配」(≥10 位)+ 输错不计数;账本读写不在锁里 猜别人订单号的后 10 位 理论上能把别人付的款激活到自己单上(概率很低);账本和回调同时写会丢记录 计数 + 加锁已修;后缀匹配建议改成全号匹配(要你们看买家实际怎么复制)
23 🟢 server.py ThreadingHTTPServer 线程数不设上限 慢请求堆积(ffmpeg 预览、打包、大下载) 小机器上线程 + 内存一起涨 建议:重活加信号量(zip 已加),或 nginx limit_conn
24 🟢 server.py queue_pos 1169 / heartbeat 1230 / claim 每次都把 orders/ 下所有 meta.json 读一遍 订单目录攒多了(sweep 不常跑的话) 现在几十单无所谓;几千单就慢 建议:现在不用动
25 🟢 脱敏误伤:server.py 53、2095、2150 脱敏把带 %s 的 URL 格式串整个换成了 "http<WIN-PATH>",格式化时会 TypeError 只影响你们给出来的这份 不是线上问题,但说明脱敏规则会吃掉 URL 里的 %s,下次出站可以留意 没动(占位值按要求保持原样)
26 🟢 前端没在用的接口 交给我的这份 order/index.html 里没有调用 /api/activate、/api/activate-payplatform、/api/set-templates — 要么是死接口(多一份攻击面),要么是前端副本比线上旧 问你们:线上页面还调不调这三个?
27 🟢 其它小问题 order_detail 返回体里 "amount" 写了两遍;IP_FAILS 等计数字典对「只来一次的 IP」永不清理;call() 每次读整个 calls.jsonl;pngcheck 不检查 IHDR 长度 / 取值、IDAT 里 zlib 流结束后的多余字节 — 都很轻 没动

我怀疑但没验证的(没有真实环境):

  • ffmpeg 生成 4096 预览的内存:解一张 4096×4096 的 8bit RGBA 要约 64MB,加上缩放缓冲,和 Python 进程本身共用 256M 的 cgroup。正常应该过得去,但几单同时完成时可能顶到。建议实测一次 4096 单的峰值内存。
  • 2048 / 4096 的无压缩 16bit 回传会超过 16MB 上限:详见渲染机那份回执第 1 条。如果成立,这些单会静默少一张无压缩版。#11 的修改至少能让它不再静默。

2. 改正意见(只列我没改、或者改了但你们要知道取舍的)

对应 # 建议改法 代价 / 风险 优先级
5 我只让 sweep 跳过 waiting / working / paid(还在流水线上的)。unpaid(一直没付款)和 done 还没收货的,照旧 72h 后清。另外建议:done 但没确认收货的单,到期从完成时间算,而不是创建时间 —— 不然渲染机晚上线两天,买家只剩一天能收货 一行,改 expire_at;这是业务口径,你们定 中
15 nginx:/order/api/submit 的 client_max_body_size 改成 15m(和后端 MAX_BODY 一致);给 add-skin、redo 单独配 15m,feedback 配 6m。再给它们加 error_page 413 = @json413; 回一段 {"ok":false,"error":"图片太大"},前端不用改就能显示人话 改配置 + reload,不停机 高(直接影响买家能不能下单)
16 最稳:管理接口单独监听一个端口(或者单独一条 nginx location 带 allow <家里 IP>; deny all;);后端看到「来源是回环但没带 X-Real-IP」就当成未知而不是本机。至少在 nginx 每条 location 都确认带了 proxy_set_header X-Real-IP $remote_addr;(片段里 /finish 那条被省略了,看不出有没有) 小 中
18 条款版本号和全文放一处(比如后端 /api/payinfo 顺带返回 terms_v + 全文,页面照着显示),改一处两边一起变 改前端要走前端那边的流程 中
22 爱发电订单号改成全号匹配(或至少 ≥ 20 位);买家复制时多出的空格 / 换行前端已经洗掉了 一行 低
23 submit / add-skin 收的请求体一个约 15MB,解码 + 清洗 + 原串一共约 4~5 份拷贝 → 单个请求峰值 ~50MB;5 个并发就顶到 256M。建议 nginx limit_conn(每 IP 2 个)+ 应用层给「收图」接口加一个 BoundedSemaphore(2) 小 中
新 取件码在 URL 的 query 里(?t=),所以它会进 nginx access log、浏览器历史,订单页上点外链时还会带进 Referer。建议:订单页加 Referrer-Policy: no-referrer;nginx 的 access log 用不带 $args 的 log_format(或把 t= map 掉);payplatform-hook.log 现在是整包 headers 落盘,注意别把平台带过来的鉴权头长期留着 改配置 中
新 下载不留痕:买家说「我的图被别人下了」,现在没法自证。建议 /dl /zip 各记一行审计(时间、单号、第几张、IP、UA,不记取件码) 小 中
中期 codes.json + 各种 jsonl / 账本 → SQLite(标准库自带 sqlite3,零依赖)。这次修的竞态(#1 #4 #12 #13 #14 + 账本)本质都是「文件当数据库用」:拿事务一把就全解决了,不用到处想锁。交接说明里写了「数据全在本地文件 + 一个 SQLite」,但代码里没看到 SQLite —— 是不是另有东西没给? 一次迁移脚本 + 改数据层;接口不用动 中(不急,锁已经补上了)

3. 你改了什么

所有改动都在 backend-site/server.py、backend-site/admin.py(+ 渲染机那份回执里的 backend-tools/ys_local.py)。 接口路径:一条都没动。 下面每条都单独标了「接口路径 / 请求响应字段 / 数据格式」三样。

改动 1 · 校验 + 绑码同锁(一码两单)

文件 / 函数:server.py 新增 redeem_bind() / unbind_codes() / _redeem_check();submit()、activate() 改用 redeem_bind()
为什么改:问题 #1、#12
改成什么:查码和绑码放进同一把锁;绑不上(被别的提交抢先了)就整单不收、删掉刚建的目录;
          订单写盘失败就把码放回 active。redeem() 保留,只查不占码,判断逻辑和 redeem_bind 共用一份。
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否] 数据格式 [否]
   (并发冲突时多一种报错文案,和原来「这张卡密已经用来下过单了」是同一句)
怎么验证的:同一张码并发提交 6 次 → 原版成 2 单,改后成 1 单;正常卡密单、网页单 + 卡密激活回归通过
有没有引入新的依赖:没有

改动 2 · 卡密规则不再只信前端报的张数

文件 / 函数:server.py submit()
为什么改:问题 #2
改成什么:张数取 max(前端报的 nTotal, 这次真提交的模板数);模板取两者并集;不认识的模板 key 提交时直接拒
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否] 数据格式 [否]
   正常页面报的 nTotal 本来就 ≥ 第一张皮肤的模板数,对正常买家没有变化
怎么验证的:「固定 1 张」+7 模板+nTotal=1 → 拒;锁模板 + 伪造 tplUnion → 拒;
          多皮肤单(第 1 张 2 个模板、整单报 3 张)照常能交
有没有引入新的依赖:没有

改动 3 · 支付回调幂等 + 串行

文件 / 函数:server.py payplatform_hook() → 拆成外层 + _payplatform_hook_locked();activate_payplatform() 同理;新增 HOOK_LOCK
为什么改:问题 #3、#22(账本读写不在锁里)
改成什么:同一个 out_trade_no「发过码」或「激活过单」都算处理过,再推一律原样回上次的 content;
          回调和「用爱发电订单号激活」共用一把锁,账本不会被同时写坏;后者输错计入冷却
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否] 数据格式 [否](账本结构不变)
怎么验证的:用假的反查结果模拟一笔 ¥6 付款:首次对上网页单并激活 ✔;原样重放 → 码数不变、返回同一段内容 ✔
          (原版:重放一次多出 1 张码,返回体里写着「这是你的卡密」)
有没有引入新的依赖:没有

改动 4 · 跨进程锁 + 原子写加固

文件 / 函数:server.py LOCK 换成 _DataLock(线程锁 + <DATA_DIR>/.lock 上的 flock);jsave();admin.py cmd_retry 加锁
为什么改:问题 #4、#14
改成什么:用法不变(还是 with LOCK:),admin.py import server 后自动用同一把文件锁;
          jsave 的临时文件名每次唯一 + 写完 fsync + 权限沿用原文件;拿不到文件锁就退回只用线程锁并打一行日志
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否] 数据格式 [否]
   ⚠️ 但:<DATA_DIR> 下会多一个空文件 .lock;临时文件名从 xxx.tmp 变成 xxx.<随机>.tmp
   (如果你们有脚本按 *.tmp 清理或备份,留意一下)
怎么验证的:另起一个进程连续发 200 张码,同时 HTTP 下 30 单 → 原版文件里只剩 15 张、还有 1 张已下单的码被改回可用;
          改后 200 张一张不少、30 张码全部是「已激活」
有没有引入新的依赖:没有(fcntl 是标准库;Windows 上不会 import 到这里)

改动 5 · sweep 不删流水线上的单

文件 / 函数:admin.py cmd_sweep()
为什么改:问题 #5
改成什么:state 是 waiting / working / paid 的单跳过,不删、不核销;其它状态口径不变
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否] 数据格式 [否]
怎么验证的:造一张 5 天前创建、还在排队的单,跑 admin.py sweep → 原版删掉并核销了码,改后保留
有没有引入新的依赖:没有

改动 6 · 卡密 / 订单号 / 取件码用 secrets

文件 / 函数:server.py new_oid() / new_owner_token() / gen_codes() / gift_batch_new() / gift_claim() / feedback()
为什么改:问题 #6
改成什么:random.choice → secrets.choice,字符表、长度、格式一个没变
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否] 数据格式 [否]
怎么验证的:回归里所有生成的码都过 CODE_RE;订单号 / 取件码格式不变
有没有引入新的依赖:没有

改动 7 · 重渲换皮肤走 PNG 核验

文件 / 函数:server.py redo()
为什么改:问题 #7
改成什么:换皮肤改用 _read_skin()(和下单、追补皮肤同一个:尺寸 + 结构核验 + 剥元数据),落盘的是清洗后的字节
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否] 数据格式 [否](不合格时多一种报错文案)
怎么验证的:尾部夹带 18 字节 → 拒、不落盘;正常皮肤换图照常可以
有没有引入新的依赖:没有

改动 8 · 反馈限频 + 磁盘闸 + 只收图片

文件 / 函数:server.py feedback();新增 feedback_allowed() / note_feedback() / _img_ext()
为什么改:问题 #8
改成什么:每 IP 10 分钟 5 条(超了回 429);磁盘不够回 503;「图片」只认 png/jpg/webp/gif 文件头
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否]
   数据格式 [是,很小]:反馈图片的文件扩展名按真实格式存(原来一律 .png),feedback/<id>.json 的 image 字段跟着变
怎么验证的:同 IP 连发 7 条 → 第 6、7 条 429;伪装成 PNG 的 exe 头不落盘
有没有引入新的依赖:没有

改动 9 · 下载 / 取皮肤边读边发

文件 / 函数:server.py 新增 H._send_file();download()、skin() 改用它
为什么改:问题 #9
改成什么:64KB 一块往外写,不整张进内存;响应头(Content-Type / Content-Length / no-store / Content-Disposition)完全不变
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否] 数据格式 [否]
怎么验证的:下载原图字节一致、带附件头;渲染机取皮肤内容一致、Content-Length 一致;端到端下单后订单页正常
有没有引入新的依赖:没有

改动 10 · finish 方法改名(框架重名)

文件 / 函数:server.py H.finish → H.finish_upload(路由 /api/finish 指过去)
为什么改:问题 #10
改成什么:只是改名,逻辑见改动 11
⚠️ 有没有动:接口路径 [否](还是 /api/finish) 请求响应字段 [否] 数据格式 [否]
怎么验证的:同一套测试,原版一轮 32 条「Exception occurred during processing of request」,改后 0 条
有没有引入新的依赖:没有

改动 11 · 部分失败要响亮

文件 / 函数:server.py finish_upload()、claim()、order_detail()
为什么改:问题 #11(以及回执模板 Q2)
改成什么:记住渲染机报过的 total(meta.plan_total),收单时按它判断收没收满;
          没收满 → meta.partial = {got, want, why, at} + 往 calls.jsonl 写一条(走「呼叫金钻」同一套通知)+ 页面文案直说「有 N 个文件没渲出来」;
          状态仍是 done(已经出好的部分照常能看、能收货);领单时清掉上一轮的 plan_total / partial
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否](note 文案多一句)
   数据格式 [是,只增]:订单 meta.json 新增 plan_total、partial 两个字段;calls.jsonl 多一种 kind="部分失败"
   —— 如果你们的通知脚本按 kind 过滤,记得把它加进去
怎么验证的:计划 4 个文件只交回 1 个 → 页面「有 3 个文件没渲出来,已经自动通知金钻补」,calls.jsonl 里有这一单
有没有引入新的依赖:没有

改动 12 · 派单带上条款版本

文件 / 函数:server.py claim()
为什么改:问题 #19
改成什么:/claim 返回的 order 里多一个 terms_v(订单真实同意的版本)
⚠️ 有没有动:接口路径 [否] 请求响应字段 [是,只增]:/api/claim 响应的 order 新增 terms_v 数据格式 [否]
   渲染机 ys_worker.py 本来就是 order_meta.get("terms_v") or TERMS_VERSION,所以**渲染机不用改**:
   老渲染机连新服务器 → 留档写对;新服务器配老渲染机也完全兼容
怎么验证的:领单返回里 terms_v = 2026-10-04.1
有没有引入新的依赖:没有

改动 13 · 其它几处小改

文件 / 函数:server.py edit_code()(拆出 _edit_code_locked,整段进锁)、gift_batch_new/add/off(写文件进锁)、
            my_coupons()/coupon_status()(一次只读一遍 codes.json)、admin_ip_ok()(去掉 "?")、
            download_zip()(成品 STORED、同时只打一个包,忙时回 503「稍等一分钟再点」)、
            order_detail()(去掉文案里的 ** 星号)
⚠️ 有没有动:接口路径 [否] 请求响应字段 [否](打包忙时多一种 503) 数据格式 [否](zip 还是标准 zip,只是成品不再二次压缩)
怎么验证的:打包下载 zip 内容完整(小票 + 两张图,字节一致);其余随回归一起跑
有没有引入新的依赖:没有

验证方式汇总

  • 测试脚本放在 backend-site/tests/回执复现测试.py:在临时目录起一份 server、从 HTTP 层打接口,全部用脚本现画的假皮肤,每条用例各用一份新数据。 用法:python3 tests/回执复现测试.py <server.py 所在目录>。对原版跑能看到哪些洞真实存在。 (你们给的这份因为脱敏弄坏了三个 URL 格式串跑不起来,我是在一份只替换了那三处的副本上跑的;线上原版可以直接跑。)
  • 结果:原版 27 条失败 13 条,改后 27 条全部通过。
  • 端到端:在测试机上用无头浏览器打开真实的 order/index.html,接到改过的后端,按买家的路径点了一遍: 卡密下单 → 填码(/code ✔ 识别有效)→ 勾条款、传皮肤(本地质检 ✔)→ 选模板 → 提交(/submit ✔)→ 结果页显示订单号, /status、/order、/tick 都是 200,页面 0 个 JS 报错。上面 #17 的星号就是这时候看到的。

4. 我们这边拿不准的,请你表态

Q1. 支付回调「不验签、改成拿开放接口反查」这个取舍,你认同吗? 认同。反查比「拿不到公钥去猜签名」硬得多 —— 前提是反查结果是唯一可信来源,推送报文只当一条「单号 X 有动静,去查一下」的通知。现在有两处还在信报文:

  • 幂等只认「发过码」(#3,已修);
  • custom_order_id 在反查结果里没有时,会退回用推送报文里的(2049 行)。幂等修好之后这个口子拿不到好处了(同一笔钱只能处理一次),但更干净的做法是金额、状态、订单号、留言全部只从反查结果取。

另外两点:反查只翻前 3 页,单子多了会查不到(会落进 need_human,不丢钱,但要人工);据我所知爱发电的 query-order 支持按 out_trade_no 精确查,请你们核对一下文档,能精确查就别翻页。 如果哪天拿到平台公钥:验签 + 反查两道都做最好;拿不到的话,反查加上「每个单号只处理一次」已经够用。

Q2. 订单状态机在「部分失败」时怎么收口? 「渲染机显式收尾」这个方向是对的:没有它就只能靠超时,会无限重渲。但原版收得太安静,而且收单时张数口径不一致(#11)。我改成:服务器记住计划张数,收单缺张就记 partial + 通知金钻 + 页面说实话,已经出好的部分照常能收货、能下载。 再往前一步(没做,要你们定):缺的那几张自动补渲一次(上限 1 次),还不行再转人工;页面上把缺的是哪几张列出来。

Q3. 「改完不生效」除了「先杀旧进程再起新的」,有没有更稳的机制? 有:让进程自己报版本。部署时把代码的 git 提交号或文件 sha256 写进一个常量;渲染机心跳里带上它,服务器存进 heartbeat.json、在 /status 和面板上显示;部署脚本比对「期望版本 == 心跳报上来的版本」才算成功。这样旧进程还活着会立刻看出来,不用猜。服务器那边同理:systemd 的 ExecStartPost 或部署脚本打一下 /api/status 看版本号。 Windows 那边:用 NSSM / WinSW 把渲染机装成服务,「重启」的语义是确定的(停、等退出、再起),比计划任务的「运行」可靠。

Q4. 单机多单:如果要同时渲多单,怎么才不会把机器顶满? 我会先不加并发、先加吞吐:现在每张图都要冷启动一次 Blender、加载一次工程,固定开销不小。同一个模板的多张皮肤放进同一个 Blender 进程里连着渲(换贴图、再渲),通常比开两个进程更快、峰值还更低。 真要并发的话:瓶颈是显存不是 CPU。按模板估一个显存占用,用一个「显存预算」信号量决定同时开几个;Blender 进程设成低于正常优先级、限定 Cycles 线程数;白天只开一个槽,夜里再开第二个。服务器 /claim 不用改,渲染机开两个消费线程各领各的就行(领单本身是原子的)。

Q5. 技术栈:换你会不会上框架? 不会换 Web 框架。这个规模下纯标准库完全够,换框架解决不了这次发现的任何一个问题。 真正缺的是数据层:这次的大部分问题(一码两单、CLI 和服务器互相覆盖、账本丢记录、半截 JSON)本质都是「拿 JSON 文件当数据库」。标准库自带的 sqlite3 一个事务就全解决了,零依赖、零安装,小机器也跑得动。路由和校验可以保持现在这样。

Q6. 前后端共用一个质检脚本,值不值? 值。前端拦是给人看的体验,后端剥是安全边界,规则来自同一份就不会出现「网页说能传、后端说不行」。 但这次也说明了:比「两边一致」更要紧的是「每个收皮肤的入口都过后端核验」 —— 重渲换皮肤那条路就漏了(#7)。现在所有入口都收敛到 _read_skin() 一个函数,以后新加入口也请走它。 另外 pngcheck.py 里提到的 tests/png_struct_test.py(共享用例)这次没带过来,有的话请补一份,它是「两边一致」唯一的保证。


5. 苏达(运维)另外想知道的

  • 3100 行的单文件该不该拆、先拆哪块? 该拆,但不急。先拆数据层(codes / orders / 账本的读写 + 锁,约 300 行)—— 这次的 bug 一大半在这里,拆出来才好单测;再拆支付回调(钱相关,最需要单测)。HTTP 路由放最后,它最不容易出事。

  • 卡密和订单用 JSON 文件存,并发写和「写到一半崩了」风险多大? 实测给你一个数:CLI 一边发码、服务器一边下单,原版 200 张码丢了 185 张。这次的低成本加固已经做了(跨进程 flock + 唯一临时文件 + fsync),改后 0 丢失。中期还是建议换 SQLite(见 Q5)。

  • 限流放两处(nginx + 应用),是重复还是互补?会不会打架? 互补:nginx 按请求速率挡刷接口,应用按业务语义挡(同 IP 开单数、输错冷却)。 打架的地方有两个:① 请求体大小 nginx 4m / 1m 对上应用的 10MB(#15);② nginx 回 429 / 413 时给的是 HTML,前端按 JSON 解析会失败,买家只看到一句笼统的错。建议 nginx 的 413 / 429 都回一段 JSON(error_page + 一个返回 JSON 的 location)。

  • 内存受限的前提下,还有哪些地方可能爆? ① 下载整张读进内存(已改);② 收图接口单个请求峰值约 50MB,5 个并发就到 256M(建议见第 2 节 #23);③ ffmpeg 做 4096 预览(未验证,建议实测);④ 线程不设上限。

  • 日志与审计够不够追责? 不够自证「我的图被别人下了」:下载根本不留记录(建议见第 2 节)。反过来,有些地方又记得太多:nginx access log 里有取件码(URL 的 ?t=),payplatform-hook.log 整包 headers 落盘。建议审计记「谁、什么时候、哪一单、哪一张」,但不记凭证本身。

  • 有没有「完全没想到」的角度?

    • 取件码放在 URL 里:会进浏览器历史、服务器日志,订单页上点外链还会通过 Referer 带出去。订单页加 Referrer-Policy: no-referrer 成本最低。
    • 随机数(#6):「码空间够大,暴力猜不中」这个论证只防盲猜,防不住预测。
    • 框架方法重名(#10):继承标准库的类时,自己的方法名别和父类撞,finish / handle / setup 都是保留的。
    • 买家数据的保留期:渲染机那边永久留档了买家皮肤和成品(你们已知缺口 2)。从隐私角度,建议给留档也定一个保留期,至少能按订单号删。

6. 你没验证的部分

  • 真实 nginx 配置(只看了片段;/finish 那条省略了 headers,看不出有没有带 X-Real-IP)。
  • 爱发电真实的反查返回结构(custom_order_id 到底在不在反查结果里)—— 我是拿假的反查结果测的。
  • ffmpeg 预览:测试机没有水印字体,预览那一步我用「直接拷一份」顶替了,水印本身没测。
  • 2048 / 4096 的真实成品大小、ffmpeg 峰值内存(没有渲染机、没有真实成品)。
  • systemd / cgroup 配置、定时任务(sweep 多久跑一次)都没看到。

7. 你还需要什么材料

  • 线上 nginx 里 /order/ 相关的完整配置(脱敏)。
  • 一份 4096 单的成品文件大小(标准版 + 无压缩各多大)。
  • 爱发电 query-order 返回的一条样例(脱敏)。
  • tests/png_struct_test.py。
  • systemd unit(MemoryMax 等)和跑 admin.py sweep 的定时任务。

以上改动都还只在工作区,等你们(和 ywsabc2)看过再决定要不要合。