uni-app对接Python接口的关键在于请求配置、参数格式与错误处理:GET需拼URL不传data,POST须匹配Content-Type及后端解析方式;必须配置CORS支持跨域;需区分res.statusCode(HTTP状态)与res.data.code(业务状态);上线前务必备案HTTPS域名并配SSL证书。

uni-app 对接 Python 接口不是“能不能”的问题,而是“怎么配、怎么传、怎么防错”的问题。只要后端返回标准 JSON、CORS 开放、路径可访问,前端基本不会卡在协议层——真正掉坑的地方,往往出在请求头、参数格式、错误码处理这三块。
uni.request 的 method 和 data 必须匹配后端预期
Python 后端(Django/Flask/FastAPI)默认对 GET 和 POST 的数据解析方式不同:GET 参数走 URL 查询字符串,POST 默认从 request body 读 JSON 或表单数据。uni-app 里不写清楚,很容易 400 或空数据。
-
GET请求:把参数拼进url,不要塞data字段,否则 uni 会自动转成 request body,后端收不到 -
POST请求:如果后端用request.get_json()(Flask)或request.data(Django),前端必须设header: {'Content-Type': 'application/json'},且data是 JS 对象(uni 会自动序列化) - 如果后端是 Django 的
request.POST(表单提交),前端就得用application/x-www-form-urlencoded,data要手动encodeURIComponent拼串,不如直接用URLSearchParams
Django/Flask 必须处理跨域(CORS),否则 uni.request 直接被浏览器拦截
uni-app 编译到 H5 时走浏览器环境,微信小程序真机调试也走本地 HTTPS 代理,但开发时 localhost:8080 → http://127.0.0.1:8000 这类请求,没有 CORS 响应头,uni.request 会在控制台报 net::ERR_FAILED 或静默失败,连 network 面板都看不到请求发出。
- Django 推荐装
djangorestframework-cors-headers,加中间件并配置CORS_ALLOWED_ORIGINS = ['http://localhost:8080', 'https://devtools.qyapi.com'] - Flask 可用
flask-cors,一行CORS(app, origins=['http://localhost:8080'])就够 - 别信“小程序不用跨域”——H5 端和真机调试的开发者工具里,它就是浏览器,该拦照样拦
uni.request 成功回调里的 res.data 不等于后端 return 的字典
很多 Python 接口习惯直接 return {'code': 0, 'data': {...}},但 uni-app 的 res 是完整响应对象,res.data 才是 HTTP body 解析后的结果。新手常误以为 res.code 是接口状态码,其实那是业务字段;真正的 HTTP 状态码是 res.statusCode。
- 务必检查
res.statusCode === 200,再判断res.data.code === 0,否则网络异常或 500 错误时,res.data可能是字符串(如 Django 的 500 页面 HTML) - 后端返回非 JSON(比如重定向、空响应、text/plain)会导致
res.data解析失败,res.errMsg会提示parse fail - 建议后端统一用
Response({'code': 0, 'msg': 'ok', 'data': ...}, status=200)(DRF)或jsonify()(Flask),避免裸 dict 返回
微信小程序真机调试要关掉“校验合法域名”,但上线前必须配好
开发阶段勾选“不校验合法域名”能让请求通,但这是假象。一旦上线,微信强制校验 request 的域名是否在小程序后台「开发管理 > 服务器域名」里备案,且只支持 HTTPS。这时候 Python 后端没配 SSL 证书,或者用了自签名证书,请求会直接失败,控制台只显示 request:fail ssl hand shake error。
- 本地联调可用 ngrok 或 localtunnel 临时映射 HTTPS 域名,避免反复改备案
- 正式部署必须用 Let’s Encrypt 或云厂商免费证书,Nginx 反向代理时注意透传
X-Forwarded-Proto,否则 Flask/Django 的request.is_secure判定会错 - 别忽略
uni.uploadFile和uni.downloadFile也受同一套域名白名单限制,上传图片、导出 Excel 都得提前加进去
最常被跳过的细节是:Python 日志里 400 错误写着 “JSON decode error”,但 uni-app 控制台没报错——因为请求发出去了,只是后端解析失败后返回了 400,而前端没监听 fail 回调或检查 res.statusCode。对接不是连上就行,是每一层的约定都要对齐。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











