检查日志,如果出现以下日志,则代表调用customScan.init方法时已获得相机权限:
C05506/包名/ScanFrameworkCustomScan 包名 I [InitScan:551] customScan.init is called C05506/包名/ScanFrameworkCustomScan 包名 I [InitScan:564] camera granted ... C05506/包名/ScanFrameworkCustomScan 包名 I [InitScan:593] end InitScan
若未出现上述日志,则是还未调用init方法或者未获取相机权限。如下日志代表调用init方法时还未获得相机权限:
C05506/包名/ScanFrameworkCustomScan 包名 I [InitScan:551] customScan.init is called C05506/包名/ScanFrameworkCustomScan 包名 E [InitScan:556] camera not granted C05506/包名/ScanFramework 包名 I [CreateBusinessError:30] CreateBusinessError errCode: 201 errMsg: Permission denied.
需要考虑用户拒绝授权后,应用没有再调用init方法的场景,该场景下不会出现上方的日志,此时需要参照下方第1.3步检查用户是否拒绝授权。
排查缺少相机权限的详细原因:
[IsDynamicRequest:444]Permission: ohos.permission.CAMERA: state: 2, errorReason: 2
[SPC][PermissionDialog][Model]: terminate session with result, resultCode: 1, reqPerms: [ohos.permission.CAMERA], result: [-1].
[IsDynamicRequest:444]Permission: ohos.permission.CAMERA: state: -1, errorReason: 0 [RequestPermissionsFromUserExecute:704]It does not need to request permission
C05506/包名/ScanFramework 包名 I [CreateBusinessError:30] CreateBusinessError errCode: 1000500001 errMsg: Internal error. ScanOption is null, please call customScan.init first. C05506/包名/ScanFramework 包名 I [CreateBusinessError:57] CreateBusinessError exit
错误流程示意图:

出现该问题可能得原因有:
C05506/包名/ScanFramework 包名 I [CreateBusinessError:30] CreateBusinessError errCode: 401 errMsg: Parameter error. ViewControl's height range error. C05506/包名/ScanFramework 包名 I [CreateBusinessError:57] CreateBusinessError exit
此处是高度异常,宽度异常对应ViewControl's width range error.。此时应用正常会闪退,如果应用自行抓取处理错误就不会闪退,但扫码区域会黑屏。
C05506/包名/ScanFramework 包名 I [CreateBusinessError:30] CreateBusinessError errCode: 401 errMsg: Parameter error. ViewControl's surfaceid range error. C05506/包名/ScanFramework 包名 I [CreateBusinessError:57] CreateBusinessError exit
以下日志代表surfaceId错误,surfaceId无效:
C05506/包名/ScanFrameworkCustomScan 包名 E [AdjustRenderFit:379] AdjustRenderFit failed, due to CreateNativeWindowFromSurfaceId fail, ret: 40001000 ... C05506/包名/ScanFrameworkCustomScan 包名 E [CreatePreviewOutput:744] Failed to get CreatePreviewOutput surface C05506/包名/ScanFrameworkCustomScan 包名 E [CreateCaptureOutput:714] Create preview output failed, ret: -2
surfaceId错误时应用正常会闪退,如果应用自行抓取处理错误就不会闪退,但扫码区域会黑屏显示。
排查流程图如下:

流程图中置绿色背景部分是较新版本中宽高比不匹配时也能正常扫码,不会黑屏。在2025年5月之前的版本中,宽高比不匹配会有报错日志Internal error. The width and height of viewControl do not match the width and height supported by the camera.,并且扫码区域显示黑屏。后续版本已移除相关报错,可以正常显示画面,但会出现画面拉伸问题影响预览流体验,建议宽高比保持在16:9、4:3、1:1范围内。
如果在返回扫码页面时出现以下日志,则代表相机重启失败,执行start方法前没有调用customScan.stop、customScan.release接口释放扫码相机流:
C05506/包名/ScanFramework 包名 I [CreateBusinessError:30] CreateBusinessError errCode: 1000500001 errMsg: Internal error. Camera restart camera session failed. C05506/包名/ScanFramework 包名 I [CreateBusinessError:57] CreateBusinessError exit
该场景下扫码区域会画面静止,重新进入扫码页面时扫码区域才会显示黑屏。