html5-qrcode无法识别PDF_417格式，求阿根廷DNI扫描解决方案

先修正配置中的冗余问题 #

你的配置里重复设置了useBarCodeDetectorIfSupported属性（同时在experimentalFeatures对象和顶层配置中声明），这可能导致逻辑冲突，建议简化配置：

var html5QrcodeScanner = new Html5QrcodeScanner(
    "reader", { 
      fps: 10, 
      qrbox: { width: 400, height: 400 },
      formatsToSupport: [Html5QrcodeSupportedFormats.PDF_417],
      experimentalFeatures: { useBarCodeDetectorIfSupported: true }
    });

排查浏览器对PDF_417的支持情况 #

不同浏览器的BarCodeDetector API对PDF_417的支持存在差异，阿根廷DNI的条码可能有特定编码规则。可以通过以下代码检测当前环境的支持情况：

if ('BarcodeDetector' in window) {
  const detector = new BarcodeDetector({ formats: ['pdf417'] });
  detector.getSupportedFormats().then(formats => {
    console.log('当前浏览器支持的条码格式:', formats);
  }).catch(err => {
    console.error('检测支持格式失败:', err);
  });
} else {
  console.log('当前浏览器不支持BarCodeDetector API');
}

如果浏览器不支持该API，html5-qrcode会 fallback 到纯JS引擎，但纯JS引擎对PDF_417的识别率可能偏低，尤其是针对复杂布局的条码。

优化扫描参数与环境 #

• 调整扫描框尺寸：阿根廷DNI的PDF_417是长条状，建议修改qrbox为适配宽高比，比如{ width: 300, height: 150 }，让扫描框更贴合条码形状。
• 提升帧率：将fps从10调高到15-20，增加扫描频次，提高捕捉条码的概率。
• 改善扫描环境：确保光线充足（避免逆光/暗光），保持DNI与相机距离在10-20cm，让条码清晰填充扫描框。

尝试切换扫描引擎 #

如果BarCodeDetector API无法识别，可强制使用html5-qrcode的纯JS扫描引擎，关闭useBarCodeDetectorIfSupported：

var html5QrcodeScanner = new Html5QrcodeScanner(
    "reader", { 
      fps: 15, 
      qrbox: { width: 300, height: 150 },
      formatsToSupport: [Html5QrcodeSupportedFormats.PDF_417],
      experimentalFeatures: { useBarCodeDetectorIfSupported: false }
    });

纯JS引擎对部分特殊条码的兼容性可能更好。

验证条码本身有效性 #

先用手机端条码扫描APP测试DNI的PDF_417条码，确认条码无损坏或印刷异常。如果其他工具也无法识别，问题可能出在DNI条码本身。

内容的提问来源于stack exchange，提问作者Luca Di Nardo