From b6e2a376e602d686c7cd1d8a27e28522775cc26f Mon Sep 17 00:00:00 2001
From: quyixiao <2621048238@qq.com>
Date: Sat, 6 Jun 2026 00:59:55 +0800
Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BA=A4=E4=BF=AE=E6=94=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../RecognizeDrivingLicenseController.java | 572 +++++++++++++++++-
.../test/java/com/api/test/ImageToBase64.java | 79 +++
.../api-interface/src/test/resources/aaa.jpg | Bin 0 -> 232085 bytes
3 files changed, 636 insertions(+), 15 deletions(-)
create mode 100644 api-web/api-interface/src/test/java/com/api/test/ImageToBase64.java
create mode 100644 api-web/api-interface/src/test/resources/aaa.jpg
diff --git a/api-web/api-interface/src/main/java/com/heyu/api/controller/car/RecognizeDrivingLicenseController.java b/api-web/api-interface/src/main/java/com/heyu/api/controller/car/RecognizeDrivingLicenseController.java
index 2e2f2f5..e188f0f 100644
--- a/api-web/api-interface/src/main/java/com/heyu/api/controller/car/RecognizeDrivingLicenseController.java
+++ b/api-web/api-interface/src/main/java/com/heyu/api/controller/car/RecognizeDrivingLicenseController.java
@@ -1,43 +1,585 @@
package com.heyu.api.controller.car;
-import com.heyu.api.baidu.handle.traffic.BVehicleLicenseHandle;
-import com.heyu.api.baidu.request.traffic.BVehicleLicenseRequest;
import com.heyu.api.controller.BaseController;
-import com.heyu.api.controller.ocr.BaiduOcrResult;
import com.heyu.api.data.annotation.EbAuthentication;
import com.heyu.api.data.constants.ApiConstants;
+import com.heyu.api.data.utils.MapUtils;
import com.heyu.api.data.utils.R;
import com.heyu.api.data.utils.StringUtils;
import com.heyu.api.request.car.VehicleLicenseRequest;
-import org.springframework.beans.factory.annotation.Autowired;
+import com.heyu.api.resp.car.RecognizeDrivingLicenseBackResp;
+import com.heyu.api.resp.car.RecognizeDrivingLicenseFaceResp;
+import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
+import java.lang.reflect.Field;
+import java.util.Collections;
+import java.util.EnumSet;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * 行驶证识别控制器
+ *
+ * 能力说明：对机动车行驶证主页（正页）、副页及电子行驶证进行结构化识别，
+ * 底层对接百度智能云文字识别「行驶证识别」能力，由本服务完成参数校验、请求转发与字段映射。
+ *
+ *
+ * 百度官方文档
+ *
+ * - 产品文档：行驶证识别
+ * - 接口地址：{@code POST https://aip.baidubce.com/rest/2.0/ocr/v1/vehicle_license}
+ *
+ *
+ * 本服务接口
+ *
+ * - 路径：{@code POST /driving/license/recognize}
+ * - Content-Type：{@code application/x-www-form-urlencoded} 或 {@code application/json}（{@code @RequestBody}）
+ * - 鉴权：{@link EbAuthentication}（Tencent 鉴权头，见项目网关配置）
+ *
+ *
+ * 请求参数（{@link VehicleLicenseRequest}）
+ *
+ * - imageBase64 / imageUrl：二选一，图片 jpg/jpeg/png/bmp，编码后≤4M
+ * - side：{@code front} 主页（默认），{@code back} 副页；映射百度 {@code vehicle_license_side}
+ *
+ *
+ * 返回约定（重要）
+ *
+ * - 入参校验失败：{@code R.error()}，未调用百度、不计费
+ * - 已调用百度识别链路：一律 {@code R.ok()}；异常说明写入 {@code msg}（对外不暴露「百度」字样）
+ *
+ *
+ * @author heyu
+ * @since 1.0.0
+ * @see VehicleLicenseRequest
+ * @see RecognizeDrivingLicenseFaceResp
+ * @see RecognizeDrivingLicenseBackResp
+ */
+@Slf4j
@RestController
@RequestMapping("/driving/license")
public class RecognizeDrivingLicenseController extends BaseController {
- @Autowired
- private BVehicleLicenseHandle bVehicleLicenseHandle;
+ /** 百度行驶证识别 API 路径 */
+ private static final String VEHICLE_LICENSE_URI = "/rest/2.0/ocr/v1/vehicle_license";
+ private static final String SIDE_DEFAULT_HINT = "未传(将按正页处理)";
+
+ /**
+ * 行驶证识别
+ *
+ * @param request 行驶证识别请求
+ * @return 正页返回 {@link RecognizeDrivingLicenseFaceResp}；副页返回 {@link RecognizeDrivingLicenseBackResp}
+ */
@EbAuthentication(tencent = ApiConstants.TENCENT_AUTH)
@PostMapping("/recognize")
public R recognize(@RequestBody VehicleLicenseRequest request) {
- return BaiduOcrResult.raw(bVehicleLicenseHandle.handle(toBaiduRequest(request)));
+ long start = System.currentTimeMillis();
+ RecognizeContext ctx = null;
+ try {
+ String validateError = validateRequest(request);
+ if (validateError != null) {
+ log.info("行驶证识别：参数检查没通过，直接返回错误（还没调识别、不扣费）。{} 返回给客户：{}",
+ buildInputLogContext(request), abbreviate(validateError, 120));
+ return R.error(validateError);
+ }
+
+ ctx = new RecognizeContext(
+ resolveVehicleLicenseSide(request),
+ ImageMode.of(request),
+ buildInputLogContext(request));
+
+ String content = buildRequestContent(request, ctx.side);
+ if (isBlank(content)) {
+ log.error("行驶证识别：组装请求失败，请求里没带有效图片。识别{}，{}。{}",
+ sideDesc(ctx.side), ctx.imageMode.desc, ctx.inputLog);
+ return okResult(ctx.side, formatHint(
+ "报文组装异常",
+ "识别请求体在序列化后未包含任何影像载荷，平台侧无法受理本次识别",
+ "请核对 imageBase64 是否已 urlencode、imageUrl 是否非空字符串",
+ "目标页面=" + sideLabel(ctx.side) + "，影像模式=" + ctx.imageMode.name()
+ ), null);
+ }
+
+ Map platformResult = callPlatform(content, ctx);
+ if (platformResult == null) {
+ return okResult(ctx.side, formatHint(
+ "服务无回执",
+ "识别指令已下发，但在约定时间内未收到平台可解析的 JSON 回执",
+ "建议间隔 3~5 秒重试；若连续失败，请记录 traceId、调用时刻与 side 并联系技术支持",
+ "目标页面=" + sideLabel(ctx.side) + "，影像模式=" + ctx.imageMode.name()
+ ), null);
+ }
+
+ Object data = ApiConstants.back.equals(ctx.side)
+ ? buildBackResp(platformResult)
+ : buildFaceResp(platformResult);
+ String hint = resolvePlatformHint(platformResult, ctx, data);
+
+ logRecognizeResult(ctx, platformResult, data, hint, start);
+ return okResult(ctx.side, hint, data);
+
+ } catch (Exception e) {
+ long cost = System.currentTimeMillis() - start;
+ String side = ctx != null ? ctx.side
+ : (request != null ? resolveVehicleLicenseSide(request) : ApiConstants.front);
+ String mode = ctx != null ? ctx.imageMode.desc
+ : (request != null ? ImageMode.of(request).desc : "未知");
+ log.error("行驶证识别：程序运行出错，耗时 {} ms。识别{}，{}。客户传的：{}。异常：{} - {}",
+ cost, sideDesc(side), mode, buildInputLogContext(request),
+ e.getClass().getSimpleName(),
+ e.getMessage() != null ? e.getMessage() : "无具体说明", e);
+ return okResult(side, formatHint(
+ "运行时故障",
+ "服务端在处理识别流程时抛出未预期异常，识别结果不可用",
+ "请勿重复高频重试；请保存 traceId、异常发生时间及 side，由技术支持结合堆栈进一步定位",
+ "异常类型=" + e.getClass().getSimpleName()
+ + (e.getMessage() != null ? "，摘要=" + e.getMessage() : "")
+ ), null);
+ }
}
- private BVehicleLicenseRequest toBaiduRequest(VehicleLicenseRequest request) {
- BVehicleLicenseRequest bRequest = new BVehicleLicenseRequest();
+ private Map callPlatform(String content, RecognizeContext ctx) {
+ int len = content.length();
+ log.info("行驶证识别：开始调用平台识别。识别{}，{}，请求大小约 {} 字节。{}",
+ sideDesc(ctx.side), ctx.imageMode.desc, len, ctx.inputLog);
+ Map result = requestBaidu(VEHICLE_LICENSE_URI, content);
+ if (result == null) {
+ log.error("行驶证识别：平台没有返回结果（可能网络超时、鉴权失败或响应无法解析）。"
+ + "识别{}，{}，请求约 {} 字节。{}",
+ sideDesc(ctx.side), ctx.imageMode.desc, len, ctx.inputLog);
+ }
+ return result;
+ }
+
+ private String resolvePlatformHint(Map platformResult, RecognizeContext ctx, Object data) {
+ Object errorCodeObj = platformResult.get("error_code");
+ if (errorCodeObj != null) {
+ String errorCode = String.valueOf(errorCodeObj);
+ Object errorMsgObj = platformResult.get("error_msg");
+ String errorMsg = errorMsgObj != null ? errorMsgObj.toString() : "平台未返回文字描述";
+ String category = PlatformError.categoryOf(errorCode);
+ log.error("行驶证识别：平台拒绝了本次识别。[{}] 错误码 {}，原因：{}。识别{}，{}。客户传的：{}。{}",
+ category, errorCode, errorMsg,
+ sideDesc(ctx.side), ctx.imageMode.desc,
+ ctx.inputLog, buildPlatformReceiptSummary(platformResult));
+ return formatHint(
+ category,
+ PlatformError.reasonOf(errorCode),
+ PlatformError.suggestionOf(errorCode, sideLabel(ctx.side)),
+ "错误码=" + errorCode + "，错误描述=" + errorMsg + "，目标页面=" + sideLabel(ctx.side)
+ );
+ }
+ if (isWordsResultEmpty(platformResult)) {
+ log.info("行驶证识别：平台返回了，但没有识别结果数据（可能不是行驶证或 side 传错）。识别{}，{}。客户传的：{}。{}",
+ sideDesc(ctx.side), ctx.imageMode.desc,
+ ctx.inputLog, buildPlatformReceiptSummary(platformResult));
+ return formatHint(
+ "结构化结果缺失",
+ "平台回执未包含可解析的识别结果集合，无法进入字段映射环节",
+ "优先排查：① 上传内容是否为行驶证对应页面；② side 是否与实物一致（正页 front、副页 back）；"
+ + "③ 使用 URL 时确保图片链接可公网访问且无防盗链",
+ "目标页面=" + sideLabel(ctx.side) + "，解析状态=结果集为空"
+ );
+ }
+ if (isAllStringFieldsBlank(data)) {
+ log.info("行驶证识别：平台有返回，但号牌、所有人等字段一个都没识别出来（可能传错正/副页或图片不清晰）。"
+ + "识别{}，{}。客户传的：{}。平台回执：{}",
+ sideDesc(ctx.side), ctx.imageMode.desc,
+ ctx.inputLog, buildPlatformReceiptSummary(platformResult));
+ return formatHint(
+ "字段映射为空",
+ "平台回执已通过结构校验，但号牌号码、所有人、车辆类型等结构化字段均未命中",
+ ApiConstants.back.equals(ctx.side)
+ ? "副页识别请确认 side=back，画面包含检验记录、核定载人数、外廓尺寸等区域"
+ : "正页识别请确认 side=front，画面须包含完整行驶证主页；电子行驶证需保证截图清晰",
+ "目标页面=" + sideLabel(ctx.side) + "，已映射字段数=0"
+ );
+ }
+ return null;
+ }
+
+ private void logRecognizeResult(RecognizeContext ctx, Map platformResult,
+ Object data, String hint, long start) {
+ long cost = System.currentTimeMillis() - start;
+ int mapped = countNonBlankStringFields(data);
+ if (StringUtils.isNotBlank(hint)) {
+ log.info("行驶证识别：处理结束（接口仍返回成功，但带了提示信息）。耗时 {} ms，识别出 {} 个字段。"
+ + "识别{}，{}。客户传的：{}。平台回执：{}。给客户的提示：{}",
+ cost, mapped, sideDesc(ctx.side), ctx.imageMode.desc,
+ ctx.inputLog, buildPlatformReceiptSummary(platformResult), abbreviate(hint, 120));
+ } else {
+ log.info("行驶证识别：识别成功。耗时 {} ms，共识别出 {} 个字段。识别{}，{}。客户传的：{}。平台回执：{}",
+ cost, mapped, sideDesc(ctx.side), ctx.imageMode.desc,
+ ctx.inputLog, buildPlatformReceiptSummary(platformResult));
+ }
+ }
+
+ private String validateRequest(VehicleLicenseRequest request) {
if (request == null) {
- return bRequest;
+ log.info("行驶证识别：没收到任何请求参数，直接拒绝，未调用识别、不扣费");
+ return formatHint(
+ "入参绑定失败",
+ "控制器未接收到可绑定的请求对象，所有业务字段均为空",
+ "请确认使用 POST 提交；字段名与接口文档一致（imageBase64 / imageUrl / side）",
+ "绑定结果=VehicleLicenseRequest 为 null"
+ );
}
- bRequest.setImageBase64(request.getImageBase64());
- bRequest.setImageUrl(request.getImageUrl());
- if (StringUtils.isNotBlank(request.getSide())) {
- bRequest.setVehicleLicenseSide(request.getSide());
+ if (isBlank(request.getImageBase64()) && isBlank(request.getImageUrl())) {
+ log.info("行驶证识别：没传图片（imageBase64 和 imageUrl 都为空），直接拒绝，未调用识别、不扣费。{}",
+ buildInputLogContext(request));
+ return formatHint(
+ "影像源缺失",
+ "imageBase64 与 imageUrl 均未提供，识别引擎没有可处理的图像输入",
+ "任选其一：① imageBase64 传 jpg/jpeg/png/bmp 的 base64（urlencode 后≤4M）；"
+ + "② imageUrl 传可公网直连的地址（≤1024 字符，关闭防盗链）",
+ "side=" + (isBlank(request.getSide()) ? SIDE_DEFAULT_HINT : request.getSide().trim())
+ );
+ }
+ if (StringUtils.isNotBlank(request.getImageBase64()) && StringUtils.isNotBlank(request.getImageUrl())) {
+ log.info("行驶证识别：客户同时传了 Base64 和图片链接，按规则只用 Base64，忽略链接。{}",
+ buildInputLogContext(request));
+ }
+ if (resolveVehicleLicenseSide(request) == null) {
+ log.info("行驶证识别：side 参数写错了（只支持 front 正页、back 副页），直接拒绝，未调用识别、不扣费。{}",
+ buildInputLogContext(request));
+ return formatHint(
+ "页面标识无效",
+ "参数 side 的取值无法映射到行驶证主页或副页识别模式",
+ "行驶证主页（含电子行驶证主页）请传 front；副页请传 back",
+ "当前 side=" + request.getSide() + "，合法取值=front|back"
+ );
+ }
+ return null;
+ }
+
+ private String resolveVehicleLicenseSide(VehicleLicenseRequest request) {
+ if (request == null || isBlank(request.getSide())) {
+ return ApiConstants.front;
+ }
+ String side = request.getSide().trim();
+ if (ApiConstants.front.equals(side) || ApiConstants.face.equals(side)) {
+ return ApiConstants.front;
+ }
+ if (ApiConstants.back.equals(side)) {
+ return ApiConstants.back;
+ }
+ return null;
+ }
+
+ private String sideLabel(String side) {
+ return ApiConstants.back.equals(side) ? "副页(back)" : "正页(front)";
+ }
+
+ private String sideDesc(String side) {
+ return ApiConstants.back.equals(side) ? "行驶证副页" : "行驶证正页";
+ }
+
+ private String buildRequestContent(VehicleLicenseRequest request, String vehicleLicenseSide) {
+ StringBuilder sb = new StringBuilder();
+ if (StringUtils.isNotBlank(request.getImageBase64())) {
+ sb.append("&image=").append(request.getImageBase64());
+ } else if (StringUtils.isNotBlank(request.getImageUrl())) {
+ sb.append("&url=").append(request.getImageUrl());
+ }
+ sb.append("&detect_direction=false");
+ sb.append("&vehicle_license_side=").append(vehicleLicenseSide);
+ sb.append("&unified=false");
+ sb.append("&quality_warn=false");
+ sb.append("&risk_warn=false");
+ return sb.toString();
+ }
+
+ private R okResult(String vehicleLicenseSide, String hint, Object data) {
+ if (data == null) {
+ data = ApiConstants.back.equals(vehicleLicenseSide)
+ ? new RecognizeDrivingLicenseBackResp()
+ : new RecognizeDrivingLicenseFaceResp();
+ }
+ R result = StringUtils.isNotBlank(hint) ? R.ok(hint) : R.ok();
+ return result.setData(data);
+ }
+
+ private RecognizeDrivingLicenseFaceResp buildFaceResp(Map data) {
+ RecognizeDrivingLicenseFaceResp resp = new RecognizeDrivingLicenseFaceResp();
+ resp.setPlateNumber(getWords(data, "号牌号码"));
+ resp.setVehicleType(getWords(data, "车辆类型"));
+ resp.setOwner(getWords(data, "所有人"));
+ resp.setAddress(getWords(data, "住址"));
+ resp.setUseCharacter(getWords(data, "使用性质"));
+ resp.setModel(getWords(data, "品牌型号"));
+ resp.setVin(getWords(data, "车辆识别代号"));
+ resp.setEngineNumber(getWords(data, "发动机号码"));
+ resp.setRegisterDate(firstNonBlank(getWords(data, "注册日期"), getWords(data, "注册登记日期")));
+ resp.setIssueDate(getWords(data, "发证日期"));
+ resp.setIssueAuthority(firstNonBlank(getWords(data, "发证单位"), getWords(data, "发证机关")));
+ return resp;
+ }
+
+ private RecognizeDrivingLicenseBackResp buildBackResp(Map data) {
+ RecognizeDrivingLicenseBackResp resp = new RecognizeDrivingLicenseBackResp();
+ resp.setPlateNumber(getWords(data, "号牌号码"));
+ resp.setFileNumber(getWords(data, "档案编号"));
+ resp.setApprovedPassengerCapacity(getWords(data, "核定载人数"));
+ resp.setGrossMass(getWords(data, "总质量"));
+ resp.setUnladenMass(getWords(data, "整备质量"));
+ resp.setApprovedLoad(getWords(data, "核定载质量"));
+ resp.setOverallDimension(getWords(data, "外廓尺寸"));
+ resp.setTractionMass(getWords(data, "准牵引总质量"));
+ resp.setInspectionRecord(getWords(data, "检验记录"));
+ resp.setEnergyType(firstNonBlank(getWords(data, "能源种类"), getWords(data, "燃油类型")));
+ resp.setRemark(getWords(data, "备注"));
+ resp.setCertificateNumber(getWords(data, "证芯编号"));
+ return resp;
+ }
+
+ private String getWords(Map data, String field) {
+ return MapUtils.getByExpr(data, "words_result." + field + ".words");
+ }
+
+ private String firstNonBlank(String first, String second) {
+ return StringUtils.isNotBlank(first) ? first : second;
+ }
+
+ @SuppressWarnings("unchecked")
+ private boolean isWordsResultEmpty(Map platformResult) {
+ Object wordsResult = platformResult.get("words_result");
+ if (wordsResult == null) {
+ return true;
+ }
+ if (wordsResult instanceof Map) {
+ return ((Map) wordsResult).isEmpty();
+ }
+ return false;
+ }
+
+ private static int countNonBlankStringFields(Object data) {
+ if (data == null) {
+ return 0;
+ }
+ int count = 0;
+ for (Field f : data.getClass().getDeclaredFields()) {
+ if (!String.class.equals(f.getType())) {
+ continue;
+ }
+ try {
+ f.setAccessible(true);
+ Object v = f.get(data);
+ if (v instanceof String && StringUtils.isNotBlank((String) v)) {
+ count++;
+ }
+ } catch (IllegalAccessException ignored) {
+ // ignore
+ }
+ }
+ return count;
+ }
+
+ private static boolean isAllStringFieldsBlank(Object data) {
+ return countNonBlankStringFields(data) == 0;
+ }
+
+ private String formatHint(String category, String reason, String suggestion, String detail) {
+ StringBuilder sb = new StringBuilder();
+ sb.append("【行驶证识别·").append(category).append("】").append(reason);
+ if (StringUtils.isNotBlank(detail)) {
+ sb.append("｜定位信息：").append(detail);
+ }
+ sb.append("｜处置指引：").append(suggestion);
+ return sb.toString();
+ }
+
+ private String abbreviate(String text, int maxLen) {
+ if (text == null || text.length() <= maxLen) {
+ return text;
+ }
+ return text.substring(0, maxLen) + "...";
+ }
+
+ private String buildInputLogContext(VehicleLicenseRequest request) {
+ if (request == null) {
+ return "未收到请求体";
+ }
+ String sideParam = isBlank(request.getSide()) ? "未传（默认按正页）" : request.getSide().trim();
+ String resolvedSide = resolveVehicleLicenseSide(request);
+ String targetPage = resolvedSide == null ? "side 无法识别" : sideDesc(resolvedSide);
+ ImageMode mode = ImageMode.of(request);
+ return String.format("识别%s，side 参数=%s，%s，Base64 长度 %d 字符，图片链接长度 %d 字符",
+ targetPage, sideParam, mode.desc,
+ textLength(request.getImageBase64()), textLength(request.getImageUrl()));
+ }
+
+ private String buildPlatformReceiptSummary(Map platformResult) {
+ if (platformResult == null) {
+ return "平台无任何回执";
+ }
+ Object errorCode = platformResult.get("error_code");
+ Object errorMsg = platformResult.get("error_msg");
+ Object logId = platformResult.get("log_id");
+ if (errorCode != null) {
+ return String.format("平台返回失败，错误码 %s，说明：%s，流水号 %s",
+ errorCode,
+ errorMsg != null ? errorMsg : "无",
+ logId != null ? logId : "无");
+ }
+ Object wordsResultNum = platformResult.get("words_result_num");
+ Object wordsResult = platformResult.get("words_result");
+ int fieldCount = wordsResult instanceof Map ? ((Map) wordsResult).size() : 0;
+ return String.format("平台返回成功，识别结果约 %s 项、结构化字段 %d 个，流水号 %s",
+ wordsResultNum != null ? wordsResultNum : "未知",
+ fieldCount,
+ logId != null ? logId : "无");
+ }
+
+ private int textLength(String value) {
+ return value == null ? 0 : value.length();
+ }
+
+ private static class RecognizeContext {
+ final String side;
+ final ImageMode imageMode;
+ final String inputLog;
+
+ RecognizeContext(String side, ImageMode imageMode, String inputLog) {
+ this.side = side;
+ this.imageMode = imageMode;
+ this.inputLog = inputLog;
+ }
+ }
+
+ private enum ImageMode {
+ BASE64("使用 Base64 编码图片"),
+ URL("使用图片链接"),
+ BASE64_WITH_URL_IGNORED("同时传了 Base64 和链接，实际使用 Base64"),
+ NONE("未传图片"),
+ UNKNOWN("图片提交方式未知");
+
+ final String desc;
+
+ ImageMode(String desc) {
+ this.desc = desc;
+ }
+
+ static ImageMode of(VehicleLicenseRequest req) {
+ if (req == null) {
+ return UNKNOWN;
+ }
+ boolean hasBase64 = StringUtils.isNotBlank(req.getImageBase64());
+ boolean hasUrl = StringUtils.isNotBlank(req.getImageUrl());
+ if (hasBase64 && hasUrl) {
+ return BASE64_WITH_URL_IGNORED;
+ }
+ if (hasBase64) {
+ return BASE64;
+ }
+ if (hasUrl) {
+ return URL;
+ }
+ return NONE;
+ }
+ }
+
+ private enum PlatformError {
+ QPS_DAILY_LIMIT("17", "日配额耗尽",
+ "本接口当日累计调用次数已触达平台日配额上限，本次识别请求被拒绝",
+ "请安排次日再试，或联系运营提升日调用配额"),
+ QPS_RATE_LIMIT("18", "并发限流",
+ "单位时间请求过于密集，已触发平台 QPS 限流，请拉长调用间隔后重试",
+ "请在客户端增加限流/退避策略，避免瞬时并发过高"),
+ QPS_TOTAL_EXHAUSTED("19", "总配额耗尽",
+ "平台侧总调用配额已耗尽，需运营侧扩容或次日再试",
+ "请联系运营确认平台总配额与续费状态"),
+ PARAM_FORMAT("100", "平台业务拒绝",
+ "提交的表单字段组合不符合行驶证识别接口契约，请对照文档核对字段名与取值",
+ null),
+ AUTH_INVALID("110", "鉴权失效",
+ "平台鉴权凭证校验未通过，属服务端配置异常，需运维刷新令牌",
+ "属服务端鉴权配置问题，需技术支持检查平台密钥与令牌缓存"),
+ AUTH_EXPIRED("111", "鉴权失效",
+ "平台鉴权凭证已超过有效期，属服务端配置异常，需运维重新签发",
+ "属服务端令牌过期，需技术支持重新获取并刷新缓存"),
+ PARAM_ILLEGAL("216100", "影像不合规", "存在非法或与接口不匹配的参数项", null),
+ IMAGE_MISSING("216101", "影像不合规", "影像入参缺失：未提供可用的 image 或 url 字段", null),
+ PARAM_TOO_LONG("216103", "影像不合规", "单个参数字段长度超限（常见于 url 过长或 base64 体积过大）", null),
+ APP_NOT_ENABLED("216110", "影像不合规",
+ "当前应用未开通行驶证识别能力或授权范围不包含本接口", null),
+ IMAGE_EMPTY("216200", "影像不合规",
+ "解码后的图片数据为空，上传环节可能未完成或内容损坏",
+ "请重新上传图片，确认 base64 未截断、未混入换行或非法字符"),
+ IMAGE_FORMAT("216201", "影像不合规",
+ "图片编码格式不在允许列表，仅支持 jpg、jpeg、png、bmp",
+ "请将图片转为 jpg/jpeg/png/bmp 之一后重新编码上传"),
+ IMAGE_SIZE("216202", "影像不合规",
+ "像素尺寸或编码后体积不满足规范（边长 15~4096px，编码后≤4M）",
+ "请压缩或裁剪图片，保证最长边≤4096px、最短边≥15px，且 urlencode 后≤4M"),
+ IMAGE_BLUR("216203", "影像不合规",
+ "引擎无法从当前画面中稳定提取行驶证文本，多见于模糊、过曝或非证件照",
+ null),
+ LAYOUT_FAIL("216630", "影像不合规",
+ "证件版面识别失败，建议重拍并保证四角完整、无遮挡",
+ "请平铺证件拍摄，避免手指遮挡关键字段；副页识别务必传 side=back"),
+ ENGINE_INTERNAL("282000", "引擎内部错误",
+ "平台识别引擎内部异常，属短暂性故障，可间隔数秒后重试",
+ "短暂性故障，建议 5~10 秒后单次重试，不宜连续轰炸接口");
+
+ private static final String IMAGE_PREFIX = "2162";
+ private static final String DEFAULT_CATEGORY = "平台业务拒绝";
+ private static final String IMAGE_CATEGORY = "影像不合规";
+ private static final String DEFAULT_REASON = "平台返回了未在本地维护的错误码，需结合错误描述人工判读";
+ private static final String DEFAULT_SUGGESTION =
+ "请依据错误描述调整入参或影像后重试；持续失败请附带 traceId 联系技术支持";
+
+ private static final Map BY_CODE;
+
+ static {
+ Map m = new HashMap<>();
+ for (PlatformError e : EnumSet.allOf(PlatformError.class)) {
+ m.put(e.code, e);
+ }
+ BY_CODE = Collections.unmodifiableMap(m);
+ }
+
+ final String code;
+ final String category;
+ final String reason;
+ final String suggestion;
+
+ PlatformError(String code, String category, String reason, String suggestion) {
+ this.code = code;
+ this.category = category;
+ this.reason = reason;
+ this.suggestion = suggestion;
+ }
+
+ static String categoryOf(String code) {
+ PlatformError e = BY_CODE.get(code);
+ if (e != null) {
+ return e.category;
+ }
+ if (code != null && code.startsWith(IMAGE_PREFIX)) {
+ return IMAGE_CATEGORY;
+ }
+ return DEFAULT_CATEGORY;
+ }
+
+ static String reasonOf(String code) {
+ PlatformError e = BY_CODE.get(code);
+ return e != null ? e.reason : DEFAULT_REASON;
+ }
+
+ static String suggestionOf(String code, String sideLabel) {
+ PlatformError e = BY_CODE.get(code);
+ if (e == IMAGE_BLUR) {
+ return "请在自然光下重拍，确保证面占画面主体且文字可辨；side=" + sideLabel;
+ }
+ if (e != null && e.suggestion != null) {
+ return e.suggestion;
+ }
+ return DEFAULT_SUGGESTION;
}
- return bRequest;
}
}
diff --git a/api-web/api-interface/src/test/java/com/api/test/ImageToBase64.java b/api-web/api-interface/src/test/java/com/api/test/ImageToBase64.java
new file mode 100644
index 0000000..049746c
--- /dev/null
+++ b/api-web/api-interface/src/test/java/com/api/test/ImageToBase64.java
@@ -0,0 +1,79 @@
+package com.api.test;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.HttpURLConnection;
+import java.net.URL;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.Base64;
+
+/**
+ * 图片转 Base64 工具（测试用）。
+ *
+ * 用于本地构造驾驶证识别等接口需要的 imageBase64 入参。
+ * 支持本地文件路径与 HTTP(S) 远程 URL 两种来源。
+ */
+public class ImageToBase64 {
+
+ /** 读 URL 时的连接超时（毫秒） */
+ private static final int CONNECT_TIMEOUT_MS = 5_000;
+ /** 读 URL 时的读取超时（毫秒） */
+ private static final int READ_TIMEOUT_MS = 15_000;
+
+ /**
+ * 将图片转为 Base64 字符串（不带换行、不带 data: 前缀）。
+ *
+ * @param source 本地文件绝对/相对路径，或 http(s):// 开头的远程地址
+ * @return Base64 字符串
+ */
+ public static String toBase64(String source) throws IOException {
+ if (source == null || source.trim().isEmpty()) {
+ throw new IllegalArgumentException("source 不能为空");
+ }
+ byte[] bytes = source.startsWith("http://") || source.startsWith("https://")
+ ? readFromUrl(source)
+ : readFromFile(source);
+ return Base64.getEncoder().encodeToString(bytes);
+ }
+
+ private static byte[] readFromFile(String path) throws IOException {
+ Path p = Paths.get(path);
+ if (!Files.exists(p)) {
+ throw new IOException("文件不存在: " + path);
+ }
+ return Files.readAllBytes(p);
+ }
+
+ private static byte[] readFromUrl(String url) throws IOException {
+ HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
+ conn.setConnectTimeout(CONNECT_TIMEOUT_MS);
+ conn.setReadTimeout(READ_TIMEOUT_MS);
+ conn.setRequestMethod("GET");
+ try (InputStream in = conn.getInputStream()) {
+ int status = conn.getResponseCode();
+ if (status / 100 != 2) {
+ throw new IOException("下载图片失败，HTTP " + status + "，url=" + url);
+ }
+ byte[] buf = new byte[8192];
+ java.io.ByteArrayOutputStream out = new java.io.ByteArrayOutputStream();
+ int n;
+ while ((n = in.read(buf)) > 0) {
+ out.write(buf, 0, n);
+ }
+ return out.toByteArray();
+ } finally {
+ conn.disconnect();
+ }
+ }
+
+ public static void main(String[] args) throws IOException {
+ String source = args.length > 0
+ ? args[0]
+ : "/Users/quyixiao/gita/eb-service-api/api-web/api-interface/src/test/resources/aaa.jpg";
+ String base64 = toBase64(source);
+ System.out.println("长度: " + base64.length());
+ System.out.println(base64);
+ }
+}
diff --git a/api-web/api-interface/src/test/resources/aaa.jpg b/api-web/api-interface/src/test/resources/aaa.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..f7b18009d5ee293ef5d2b01bca4d32f4da780337
GIT binary patch
literal 232085
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