From 18e01290eb8f595cc925151a858018947696c824 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=9D=83=E7=9B=8A=E5=B0=8F=E5=8A=A9=E6=89=8B=E5=BC=80?=
 =?UTF-8?q?=E5=8F=91?= <dev@quanyixiaozhushou.com>
Date: Sun, 17 May 2026 13:03:59 +0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E6=B7=BB=E5=8A=A0=E8=AE=A1=E5=88=92?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=8C=E6=9B=B4=E6=96=B0miniapp=E5=AD=90?=
 =?UTF-8?q?=E6=A8=A1=E5=9D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .trae/documents/fix-upload-route-404.md | 32 +++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 .trae/documents/fix-upload-route-404.md

diff --git a/.trae/documents/fix-upload-route-404.md b/.trae/documents/fix-upload-route-404.md
new file mode 100644
index 0000000..2b49c7a
--- /dev/null
+++ b/.trae/documents/fix-upload-route-404.md
@@ -0,0 +1,32 @@
+# 修复 /api/upload/image 404 问题
+
+## 问题原因
+
+后端 `upload.js` 路由已写入代码并本地 commit，但代码**未推送到远程**，服务器部署的是旧代码，没有 `/api/upload/image` 路由。
+
+当前后端状态：
+- 本地 commit `bfbfdcc` 包含 upload 路由和 note 字段改动
+- `origin/main` 落后 1 个 commit
+- 分支名：`main`
+
+## 修复步骤
+
+### 1. 推送 backend 子模块代码
+
+```bash
+cd backend
+git -c http.sslVerify=false push origin main
+```
+
+### 2. 更新主仓库子模块指针到 miniapp-api
+
+```bash
+cd ..
+git add backend
+git commit -m "chore: 更新backend子模块（修复upload路由404）"
+git -c http.sslVerify=false push origin master
+```
+
+### 3. 服务器重新部署
+
+服务器拉取最新 backend 代码后，`POST /api/upload/image` 即可正常响应。