root
/
jiachenlong
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
jiachenlong/docs/v1.2.4问题修复说明.md

2.9 KiB
Raw Permalink Blame History

v1.2.4 版本问题修复说明

版本: v1.2.4-stable
发布日期: 2026-03-20
维护人: 甲辰生产

问题列表及解决方案

问题1: OCR识别后保存藏品失败

现象: OCR识别成功后，点击保存藏品返回404错误

原因:

  • OCR代码只尝试小写扩展名(jpg/jpeg/png/gif)
  • 用户上传的图片文件扩展名是大写的.JPG

解决方案: 修改 backend/app/routers/ocr.py 第299行：

# 修改前
temp_extensions = [jpg, jpeg, png, gif]

# 修改后
temp_extensions = [jpg, jpeg, png, gif, JPG, JPEG, PNG, GIF]

问题2: 用户协议页面乱码

现象: 点击用户协议显示乱码，只有一个标题

原因:

  • 协议文件只有一个空的HTML骨架
  • 没有实际内容

解决方案: 创建完整的用户协议HTML文件 /var/www/frontend/user_agreement.html，包含完整的中文协议内容（服务条款、用户责任、数据安全、免责声明等）

问题3: 用户协议页面无返回按钮

现象: 打开用户协议后无法返回

解决方案: 在用户协议页面添加返回按钮：

<button class="back-btn" onclick="window.close()">← 返回</button>

问题4: 首页Logo显示不出来

现象: 登录页Logo正常，登录后首页Logo显示404

原因:

  • 部署时static目录没有复制到正确位置
  • 浏览器缓存了旧的JS文件

解决方案:

  1. 确保部署时复制static目录：
cp -r /root/jiachenlong/static /var/www/frontend/
cp -r /root/jiachenlong/static /var/www/mobile/
  1. 首页Logo添加版本号防止缓存：
// 修改Home.jsx
<img src="/static/images/jiachenlong-logo.png?v=1.2.4" ... />

问题5: 版本号显示重复

现象: 标题显示"vv1.2.4"（v重复）

原因:

  • VERSION文件中版本号为"v1.2.4"（带v前缀）
  • vite.config.js中又自动添加了"v"前缀

解决方案: 修改VERSION文件，去掉v前缀：

# 修改前
VERSION=v1.2.4

# 修改后
VERSION=1.2.4

部署检查清单

前端部署

# 1. 确保VERSION文件格式正确（不带v前缀）
cat config/VERSION
# 输出: VERSION=1.2.4

# 2. 构建
cd frontend
npm run build

# 3. 部署（两个目录都要部署）
rm -rf /var/www/mobile/*
rm -rf /var/www/frontend/*
cp -r dist/* /var/www/mobile/
cp -r dist/* /var/www/frontend/
cp -r ../static /var/www/mobile/
cp -r ../static /var/www/frontend/

# 4. 重载Nginx
nginx -s reload

后端部署

# 1. 拉取最新代码
cd /root/jiachenlong
git pull

# 2. 重启后端服务
pkill -f uvicorn
cd backend
python3 -m uvicorn app.main:app --host 0.0.0.0 --port 3000 &

标签信息

文档结束