讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

uni-app怎么对接Python接口

酷静吖_3897

酷静吖_3897

发布时间:2026-11-19 05:13:29

|

896人浏览过

|

来源于php中文网

原创

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代码,避免可变默认值、导入陷阱与运行时意外

下载

立即学习“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。对接不是连上就行,是每一层的约定都要对齐。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

相关专题

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

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

3083

2023.08.11

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

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

6783

2023.10.09

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

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

7610

2024.03.19

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

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

7578

2024.03.22

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

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

1083

2024.05.22

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

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

1951

2023.07.20

python能做什么
python能做什么

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

5564

2023.07.25

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

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

1889

2023.07.31

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn