如何自建二维码生成服务?前端 / 后端自建方案,附可直接调用 API

简介: 自建二维码有两种思路,基于开源库自研,适合内网、低流量场景,但调试、并发维护工作量大;多数业务更推荐接入第三方API(本文以探数API为例),稳定且集成快。二维码本身承载信息多、扫码便捷、容错性好,非常适合订单核销、电子凭证等业务场景。

二维码承载信息量大、成本低且易集成到系统开发,所以,在订单核销、电子凭证、产品溯源、工单系统、物料标签等业务场景里,我们经常需要生成二维码。

很多开发者第一反应就是:自建二维码生成能力。

但“自建”也分为两种思路,一种是基于开源库从零封装,另一种是在自己业务层封装转发,对接成熟API。

下面我们就把两种方案讲清楚,同时聊聊各自适合什么场景。

方案1:底层自建

适用于内网私有化系统、内部小工具、流量很小、不需要美化样式的场景。

原理很简单,调用成熟的二维码编码开源库,实现二维码内容编码、画布渲染,常用的有ZXing(Java)、qrcode(Node.js)、segno(Python)等。

简单放一段Python FastAPI示例:

from fastapi import FastAPI, Response
import segno
from io import BytesIO

app = FastAPI()

@app.get("/qr")
async def create_qr(text: str, width: int = 300):
    qrcode = segno.make(text)
    buffer = BytesIO()
    qrcode.save(buffer, kind="png", scale=width//25)
    buffer.seek(0)
    return Response(content=buffer.read(), media_type="image/png")

if __name__ == "__main__":
    import uvicorn
    uvicorn.run("main:app", host="0.0.0.0", port=8000)

优点

  • 不依赖第三方,可以部署在内部环境,数据不出内网;

  • 基础生成逻辑自主可控,没有次数限制。

缺点

  • 样式成本高:想要自定义颜色、控制边距、调节Logo大小等都要单独写代码;

  • 测试繁琐:中文编码、矢量SVG输出、不同设备兼容都要反复测试;

  • 维护成本高:识别异常、图片渲染bug,都需要开发人员排查。

方案2:业务自建封装层

很多人想要自建系统并不是方案一所说的真的“自建”,而是:拥有统一的业务出口、统一管理调用,在自己项目里封装二维码能力,不零散到处调用接口。

这种情况下,可以选择接入二维码生成API,在自己后端写一层转发封装,对外依旧是自己业务的接口,这也是兼顾可控性和效率的自建思路。

这里拿探数API的二维码生成接口举例:

请求参数

名称 必填 类型 说明
key 是 string 个人中心查看
text 是 string 二维码内容
bg_color 否 string 背景色代码,例如:ffffff
fg_color 否 string 前景色代码,例如:000000
logo 否 string logo图片URL地址或base64编码的图片内容,urlencode
width 否 string 尺寸大小(像素),例如:300
margins 否 string 边距大小(像素),例如:10
logo_width 否 string logo宽度(像素),例如:60

Python调用示例

import requests

url = "https://api.tanshuapi.com/api/qrcode/v1/index"#接口地址
params = {
   
    "key": "你的key",
    "text": "[https://www.example.com](https://www.example.com)",
    "width": "300",
    "bg_color": "ffffff",
    "fg_color": "000000",
    "margins": "10"
}
resp = requests.get(url=url, params=params)
with open("qrcode.png", "wb") as f:
    f.write(resp.content)

方案优势

  • 业务层完全自建,统一收口,后续如果需要切换底层服务,只改这一处代码,前端不用改动;

  • 原生支持Logo合成、颜色自定义,不用额外引入图片处理库,避开大量图片合成坑;

  • GET请求调试方便,参数简洁,集成速度快。

如果你的目的不是研究二维码编码原理,而是快速在业务系统落地二维码生成能力,可以选择这个方案。

两种方案对比表格

方案 可控性 工作量 适用场景
底层自建 极高 高 内网部署、严格数据隔离、低流量内部系统
接入API(以探数为例) 高 低 公网业务、订单核销、电子凭证、需要 Logo 美化

最佳实践与避坑总结

  1. 学习原理、内部工具开发:优先用开源库自建,吃透编码逻辑;
  2. 正式生产项目、对外给客户使用、需要带Logo美化:自建业务转发层,接入第三方API;
  3. 传入Logo参数时注意:url形式或者base64形式都需要做urlencode,避免参数解析异常;
  4. 按需设置边距,预留空白区域,提升扫码识别成功率。
相关文章
|
4天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1777 3
|
6天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
6天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
4天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
3788 0
|
19天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
8835 58
|
14天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3117 9
|
19天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5869 69
|
7天前
|
云安全 人工智能 安全
|
11天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1959 2