OpenCV 4.6.0 Android端C++无法解码Python可识别的二维码

问题背景 #

使用JS生成包含以下JSON字符串的二维码：

{"url":"rdp://52.170.146.204","mX":480,"mY":410,"mIn":true,"o":50,"w":2250,"h":1349,"s":300,"id":"ef4ac969"}

在OpenCV 4.6.0的Python环境中可正常解码，但同版本的Android SDK C++代码无法识别该二维码；调整JSON内容后偶尔能识别，但未发现明确规律。

排查方向与解决方案 #

1. 统一字符编码 #

JS生成二维码时，若未明确指定UTF-8编码，可能导致字符串编码与Android端OpenCV解码预期不匹配（比如rdp://这类特殊字符的处理差异）。

• 处理方式：JS端生成前，强制将JSON字符串转为UTF-8编码后再生成二维码；Android端确保解码时使用UTF-8解析结果。

2. 补充Android端图像预处理 #

Python版OpenCV默认会对输入图像做一些隐式预处理（如对比度优化、降噪），而Android C++代码往往需要手动实现：

// 示例预处理流程
Mat gray, binary;
// 灰度化
cvtColor(srcFrame, gray, COLOR_BGR2GRAY);
// 自适应阈值二值化，增强二维码对比度
adaptiveThreshold(gray, binary, 255, ADAPTIVE_THRESH_GAUSSIAN_C, THRESH_BINARY, 11, 2);
// 高斯降噪
GaussianBlur(binary, binary, Size(3, 3), 0);

3. 调整二维码检测器参数 #

Android端QRCodeDetector的默认检测参数可能比Python端更宽松或严格，手动调整参数提升检测精度：

cv::QRCodeDetector qrDetector;
// 调小检测阈值，提高精度（默认值为0.05）
qrDetector.setEpsX(0.04);
qrDetector.setEpsY(0.04);
// 执行检测解码
std::vector<cv::Point> points;
std::string decodedData = qrDetector.detectAndDecode(binary, points);

4. 优化二维码生成配置 #

JS生成器的纠错级别、二维码版本选择可能导致Android端解码容错不足：

• JS端生成时，设置最高纠错级别（H级，容错30%），避免因字符密度或特殊字符导致解码失败；
• 生成前清理JSON字符串，移除隐藏的空白字符（如换行、制表符）：

const rawJson = '{"url":"rdp://52.170.146.204","mX":480,"mY":410,"mIn":true,"o":50,"w":2250,"h":1349,"s":300,"id":"ef4ac969"}';
const cleanJson = JSON.stringify(JSON.parse(rawJson)).replace(/\s+/g, '');
// 使用cleanJson生成二维码

5. 修复Android相机图像格式问题 #

Android相机捕获的图像多为YUV格式，直接转换为BGR时可能出现颜色偏差，影响二维码识别：

// 处理YUV_420_888格式的相机帧
Mat yuvMat(imgHeight + imgHeight/2, imgWidth, CV_8UC1, imgData);
Mat bgrMat;
cvtColor(yuvMat, bgrMat, COLOR_YUV2BGR_NV21);
// 使用bgrMat进行二维码检测

内容的提问来源于stack exchange，提问作者Netanel Hadad