You need to enable JavaScript to run this app. 使用PHP存储文件上传信息到JSON文件时的重置与批量上传异常排查
优惠活动
大模型
产品
解决方案
定价
更多

使用PHP存储文件上传信息到JSON文件时的重置与批量上传异常排查

代码核心问题排查清单

单文件上传3-6次后JSON损坏重置的触发原因

  • 读写流程未加排他文件锁:json_decode读文件、追加条目、json_encode写回的全流程没有用flock加独占锁保护,一旦读写过程中出现IO中断、请求提前终止,读到的内容就是写入中途的半量碎片,解析出null后直接触发代码内置的“JSON无效就重置空结构”的分支,几次循环就会把已存的有效记录全部清掉。
  • 写入前置校验缺失:没有判断json_encode的返回值,如果文件名、存储路径、file_id里带未转义的特殊字符(比如emoji、原始换行符、未转义的引号),json_encode会直接返回false,此时如果把false/空字符串直接写入JSON文件,下一次读取必然解析失败触发重置。
  • 重置逻辑容错性为0:只要json_decode返回null就直接覆盖初始化为空的{"Files":[]}结构,没有做二次校验——比如IO异常导致临时读空、文件权限问题导致读取失败的场景,会直接把磁盘上原本合法的有效JSON文件给覆盖没。
  • 写入未启用原子标记:写文件时没有加LOCK_EX | FILE_ATOMIC参数,PHP默认的缓冲写入如果中途被打断,会直接在磁盘上留下半截JSON文本,变成永久的非法格式。

批量上传30个文件时回调异常的触发原因

  • 前端逻辑根本不是“逐个发送上传请求”:[...files].forEach(upload(file)) 这行代码会在遍历瞬间同步执行完所有upload调用,30个上传请求是并发同时打到后端的,完全不存在“逐个发送”的时序,高并发下多个进程同时读写同一个JSON文件,直接造成文件内容交叉覆盖。
  • 数据写入没有原子性保障:每个请求的处理逻辑都是「读旧JSON→往Files数组追加当前文件条目→全量覆盖写回文件」,30个并发请求会同时读到同一个初始状态的JSON内容,各自算完新的数组之后直接覆盖写回,最后磁盘上只会留下最后一个完成写入的进程的内容,前面29个请求的写入操作全部被覆盖,自然write函数的返回值和实际存储内容对不上。
  • 锁的使用存在逻辑漏洞:就算代码里加了文件锁,如果是读文件时就释放锁、写文件时再加锁,等于完全没做并发保护。必须从读取旧内容、处理新增条目、写回文件的全链路持有排他锁,才能避免多进程交叉写入。
  • 写入后没有做结果校验:写完文件后没有回读校验内容是否合法、自己刚提交的条目是否真的存在于文件中,遇到覆盖写入的场景时会直接把“写入成功”的响应返回给前端,导致前端拿到的回调值完全不符合预期。

内容的提问来源于stack exchange,提问作者ANOL GHOSH

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 05:06:11