鉴权失败最常见原因是appid与appkey填写不一致：二者须严格匹配曦灵平台生成的唯一凭证对，需核对大小写、空格、标点，确认appid为16位数字、appkey为32位小写字母数字组合，且license文件中的app_id、包名、签名md5均须一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在集成百度一镜数字人SDK时，点击“初始化SDK”按钮后弹出“鉴权失败”或“appKey无效”提示，最常见原因就是AppID与appKey填写不一致——这两个值必须严格匹配你在曦灵数字人开放平台创建应用时生成的唯一凭证对，差一个字符都会导致初始化直接中断。
确认AppID与appKey来源是否同源
第一步：登录曦灵数字人开放平台 → 进入「我的应用」列表 → 找到你正在调试的应用 → 点击「查看密钥」。
第二步：核对页面中显示的【AppID】和【AppKey】两栏内容，注意区分大小写、不可见空格、中文标点（如全角冒号、顿号）——这些在复制粘贴时极易混入。
第三步：打开你的Android项目中初始化页面（通常是DigitalHumanActivity.java或类似入口），找到填写appKey的输入框或代码赋值处，逐字比对是否与平台显示完全一致。特别注意：AppID是16位纯数字，appKey是32位小写字母+数字组合，二者绝不能互换填写。
检查Demo中配置项是否被多处修改
方法一：全局搜索“appKey”字符串，确认只有一处赋值逻辑生效。常见错误是同时在XML布局里写了默认值、在Activity onCreate里又硬编码了一次、还在assets/config.json里存了另一套——三者冲突时SDK只读取最先加载的那一份。
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
方法二：查看build.gradle中是否启用了混淆（minifyEnabled true）。如果开启了，确认proguard-rules.pro里已添加保留SDK关键类的规则：-keep class com.baidu.aip.digitalhuman.** { *; }，否则appKey字符串可能被压缩器误删或重命名。
方法三：在初始化前插入一行日志打印：Log.d("DH", "AppID=" + appId + ", appKey=" + appKey);，运行后看Logcat输出是否与平台一致。这一步能绕过UI输入框的视觉误差，直击真实传入值。
验证License文件与AppID绑定关系
进入assets目录，找到你放置的license文件（如xuniren-avatar-debug-0004.license），用文本编辑器打开它——文件头部明文写着"app_id":"1234567890123456"。这个app_id必须与你在平台查到的AppID【完全相同】，哪怕末尾多一个0也不行。
如果你曾用同一套license在多个测试包间切换，务必确认当前APK的包名（com.baidu.aip.digitalhuman.avartar）和签名MD5（6B92C246956520E715F4078D2A6E2961）仍与该license签发时一致。包名或签名变动会导致license校验失败，进而触发appKey校验跳过机制，让你误以为是Key填错。
这一步操作起来很简单，直接把license文件拖进VS Code就能看到头部字段。
