uni-app怎么对接Python接口

酷静吖_3897

酷静吖_3897

2026-11-19

896人浏览

原创

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

uni-app怎么对接python接口

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。

Python健壮编程
Python健壮编程

编写可靠Python代码,避免可变默认值、导入陷阱与运行时意外

下载
  • 务必检查 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 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3083

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6783

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7610

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7578

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1083

5

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1951

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5564

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1889

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

33937

23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习