核心是接口对齐、状态同步与借还逻辑正确性;需统一登录态处理、扫码兼容条码与二维码、借阅后主动拉取最新状态、按钮点击防重复提交。

直接上手做数字图书馆借阅 App,核心不是“能不能跨端”,而是「接口怎么对得上、状态怎么同步稳、借还逻辑怎么不出错」。uni-app 本身只是载体,真正卡住进度的,是图书状态管理、用户权限校验、离线扫码识别这三块。
uni.request 封装必须加拦截器和 token 自动续期
所有借阅、归还、预约接口都依赖用户登录态,但微信小程序和 App 的登录机制不同:小程序用 uni.login 换 code,App 可能走原生 SDK 或账号密码。不统一处理,401 错误会散落在各处。
- 在
utils/request.js里加请求前拦截:读取uni.getStorageSync('token'),没值就跳登录页,别让后续请求发出去 - 响应拦截里判断
res.statusCode === 401,自动调用刷新 token 接口(后端需提供/auth/refresh),成功后再重发原请求 - 借阅类接口(如
/api/borrow)必须带Content-Type: application/json,否则 Python Flask 后端可能收不到data
扫码借书要兼容真机摄像头 + 条码识别容错
uni-app 的 uni.scanCode 在安卓真机上默认只识别二维码,但图书馆条码多为 EAN-13 或 Code128,必须手动指定 scanType。
- 调用时显式传参:
uni.scanCode({ scanType: ['barCode', 'qrCode'] }),否则 iOS 可能扫不到 ISBN 条码 - 扫码返回的
result是字符串,但后端 API 要求字段名是isbn或barcode,前端必须清洗:去掉空格、校验位、前缀(如 “978-”) - 没扫成功时别直接报错,先 fallback 到手动输入框,用
input组件 +confirm-type="search"支持键盘搜索提交
借阅状态实时更新不能只靠轮询
用户在 A 设备借了书,B 设备的“我的借阅”列表还显示“可借”,这种体验不可接受。WebSocket 在 uni-app 里支持有限,得换思路。
- App 端可用
uni.connectSocket连 Python 后端的 WebSocket 服务(如 Flask-SocketIO),但微信小程序不支持原生 WebSocket,必须降级 - 降级方案:在关键操作后(如点击“借阅”按钮),立即触发一次
uni.request拉取最新借阅列表,再用uni.showToast提示“已更新” - 首页图书卡片右上角的“已借出”标签,不能只靠本地变量控制,每次进入页面都应查一遍
/api/user/borrowed?isbn=xxx接口
最易被忽略的是库存并发问题:两个用户同时扫同一本书,后端没加数据库行锁或乐观锁,就会超借。这不在 uni-app 范畴内,但前端得配合——借阅按钮点击后立刻置灰、显示加载中,并禁用重复点击,避免用户狂点造成多次请求。











