
证件照小程序内容安全双保险微信OpenAPI与阿里云Fallback的容错设计【免费下载链接】certificate-photo一个生成证件照的小程序微信云原生开发小程序。 只fork不star是很没品的。项目地址: https://gitcode.com/gh_mirrors/ce/certificate-photo微信小程序审核日益严格作为一款依赖用户上传照片的证件照小程序图片内容安全检测是上线的生死线。certificate-photo 这个开源证件照小程序给出了一个教科书级的答案用微信 OpenAPI 做免费主检测再让阿里云内容安全作为 Fallback 兜底形成一套几乎不会误伤用户的容错设计。无论你是想给自己的小程序加上图片审核还是单纯想学习云函数容错架构这篇教程都能帮你快速看懂它的设计思路。为什么证件照小程序必须做图片内容安全检测用户上传的照片是不可控输入。证件照场景虽然以人像为主但依然可能出现违规内容。微信官方对 UGC 图片有硬性要求凡是涉及用户上传图片的小程序都必须接入内容安全能力否则不仅无法过审还随时面临封禁风险。certificate-photo 的选择很务实——把检测放在 imgSecCheck 云函数 中用户在preEdit选图后立即触发校验从源头拦截问题图片避免脏数据流入后续的抠图、合成流程白白消耗调用次数。双保险架构微信检测为主阿里云兜底为辅整套容错设计的核心思想只有一句话主链路失败时绝不把错误抛给用户而是自动降级到备用检测通道。下面拆开看两条防线各自的分工。第一道防线微信 OpenAPI 免费图片安全检测微信云开发内置了security.imgSecCheck开放接口无需额外申请密钥在 config.json 中声明权限即可使用{ permissions: { openapi: [security.imgSecCheck] } }云函数内部通过cloud.openapi.security.imgSecCheck提交图片 buffer检测涉政、色情、暴恐等违规内容。它是全免费的主检测通道覆盖绝大多数正常场景。第二道防线阿里云内容安全 Fallback 兜底微信接口虽然免费但偶尔会抽风报错。项目作者的注释很直白——不好用老报错用阿里再检测一次。于是 AliCloud.js 承担了兜底职责通过alicloud/imageaudit20191230SDK 调用阿里云图片内容安全接口检测场景覆盖porn色情、terrorism暴恐、live涉政三类配合环境变量accessKeyId和accessKeySecret完成鉴权。容错设计的核心错误码如何驱动降级策略双保险的关键不在有两个接口而在何时切换、如何切换。看 index.js 的处理逻辑微信接口返回87014这是检测到违规的明确信号直接透传错误不需要再走阿里云微信接口抛出其他异常说明是接口自身问题而非图片问题自动降级到阿里云再检一次阿里云也调用失败返回-604102提示用户超时再试或换图阿里云检测不通过统一转换为87014与微信的错误码对齐这种设计非常聪明业务语义图片有没有问题与通道状态接口好不好用被彻底解耦。前端只需识别errCode完全不用关心背后是哪家服务在干活。前置处理超大图压缩与临时 CDN 上传检测前还有一个容易忽略的细节微信安全接口对图片尺寸有硬性限制。云函数入口先执行imageMinify压缩当图片宽度高度同时大于 750px 或任一超过 1334px 时会调用 imageCompose 云函数 等比缩放后再检测避免大图直接撞上接口限制。前端侧imgSecCheck.js 负责把本地图片通过wx.cloud.CDN转成临时 CDN 地址再传给云函数保证云端能稳定拉取到图片 buffer。前端双端联动选图检测 裁剪复检安全检测不是一次了事certificate-photo 在关键节点都埋了检测点preEdit选图后立即调用云函数做首检见 preEdit.js用户在 editPhotoPlus 里裁剪人像后会再次走一遍imgSecCheck流程防止裁剪后的画面出现新问题检测通过后才继续调用百度 AI 抠图层层把关、环环相扣。如何把这套内容安全双保险移植到自己的项目如果你想复用这套设计只需三步创建imgSecCheck云函数复制 index.js、AliCloud.js 与 config.json并在 package.json 中加入wx-server-sdk和alicloud/imageaudit20191230两个依赖在云控制台配置阿里云环境变量accessKeyId、accessKeySecret并开通阿里云内容安全服务前端封装调用参考 imgSecCheck.js 的工具函数统一处理0通过、87014违规、-604102超时三种返回码这套主备切换 错误码对齐 前端统一封装的容错设计让证件照小程序在合规和体验之间找到了平衡点微信免费通道为主阿里云兜底防挂用户几乎感知不到任何一次接口抖动。如果你的小程序也涉及用户上传图片不妨直接抄这份作业。【免费下载链接】certificate-photo一个生成证件照的小程序微信云原生开发小程序。 只fork不star是很没品的。项目地址: https://gitcode.com/gh_mirrors/ce/certificate-photo创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考