PHP实现2FA时iOS设备无法扫描QR码问题求助

我碰到过不少类似的情况，iOS端的Authy或者系统自带的「密码」APP对2FA QR码的格式要求比安卓更严格，咱们一步步来排查和解决：

1. 检查OTP URI格式是否符合标准 #

iOS的OTP解析器容错性更低，必须严格遵循RFC标准的TOTP URI格式：
otpauth://totp/[Issuer]:[AccountName]?secret=[SecretKey]&issuer=[Issuer]

重点要注意这几点：

• 账户名、发行方名称里的特殊字符（比如空格、@、#）必须用urlencode()编码，否则iOS会解析失败
• issuer参数需要在URI的开头（[Issuer]:[AccountName]部分）和查询参数里都声明，iOS的APP通常依赖这个双重标识来正确归类账户
• 密钥必须是纯Base32编码（仅包含A-Z、2-7字符），不能有空格、多余符号，长度推荐16个字符（对应80位密钥，是TOTP的标准长度）

2. 排查QR码输出的HTML转义问题 #

你代码里用了sprintf('<img src="%s"/>',...)，这里的<是HTML转义后的<，很可能导致页面输出的是文本而非正确的img标签！

你可以打开页面的源代码看看，如果看到的是<img src="...">而不是<img src="...">，那就是转义的问题。解决方法很简单：去掉HTML转义，直接输出正常的img标签即可。

3. 验证密钥的有效性 #

如果上面的都没问题，试试手动把密钥输入到iOS的Authy或者「密码」APP里：

• 如果手动输入能正常生成验证码，说明是QR码的URI格式或者生成的图片有问题
• 如果手动输入也不行，那大概率是密钥生成环节出了问题，比如生成的密钥不是标准Base32格式，或者长度不符合要求

4. 调整QR码的尺寸和纠错级别 #

iOS相机对过小、纠错级别低的QR码识别率很差，建议生成的QR码尺寸至少200x200像素，纠错级别设置为M（中等）或H（高级），这样即使图片有轻微模糊也能被识别。

给你一个符合标准的代码示例（基于你使用的PHPOTP库）：

// 生成标准Base32密钥
$secret = TokenAuth62::generateRandomBase32();
// 编码特殊字符
$issuer = urlencode("你的应用名称");
$account = urlencode("用户邮箱或账户名");
// 构建标准OTP URI
$otpUri = "otpauth://totp/{$issuer}:{$account}?secret={$secret}&issuer={$issuer}";
// 生成QR码（用库自带的方法或第三方QR生成工具）
$qrCodeDataUri = TokenAuth62::getQRCodeImageAsDataUri($otpUri, 256);
// 直接输出正确的img标签
echo "<img src='{$qrCodeDataUri}' alt='2FA 验证二维码'>";

按照上面的步骤逐一排查，大概率能解决iOS扫描QR码无效的问题~

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