Unity Vuforia安卓端不显示3D模型但编辑器正常问题求助

问题场景 #

我是AR开发新手，正在做一个简单项目：在Image Target上显示3D立方体模型。该项目在Unity编辑器中运行正常，立方体可在图片上显示，但构建为安卓包在手机运行时，相机能打开，但立方体不会显示在Image Target上。已在Vuforia配置中添加了许可证密钥，使用版本：Unity Engine - 2020.3.48f1，Vuforia version - 10.16。已尝试更换Unity 2019版本，调整Player设置（颜色空间从Linear改为Gamma、目标架构从ARMv7改为ARM64），但均无效。

核心排查步骤 #

• 确认Image Target数据库打包配置
  打开Vuforia Configuration面板，找到Databases模块，确保你的Image Target对应数据库的Build列勾选了Include，且平台指定为Android。如果是本地数据库，检查数据库文件是否存在于Assets/StreamingAssets/Vuforia目录下，未被误删或路径错误。
• 验证Vuforia许可证有效性
  重新核对Vuforia许可证密钥，确保无多余空格或拼写错误，点击Vuforia Configuration中的Check License按钮确认激活状态。部分免费许可证存在设备数量限制，可更换其他安卓设备测试。
• 检查相机权限与Vuforia初始化
  1. 在Unity Player Settings的Android > Publishing Settings中，确认Camera权限已勾选；
  2. 若项目未启用自动初始化，在场景入口脚本的Awake()或Start()中添加代码：VuforiaApplication.Instance.Initialize();，确保Vuforia正常启动；
  3. 测试时手动关闭手机相机权限，重启APP确认是否弹出权限请求，验证权限是否正常授予。
• 优化Image Target识别条件
  1. 确保测试用的实体图片与数据库中上传的图片完全一致，无缩放、模糊或打印失真；
  2. 在光线充足的环境下测试，避免强光直射或低光场景，可临时调高Image Target Inspector面板中的Sensitivity至High提升识别灵敏度；
  3. 测试时缓慢移动设备，让Image Target完整出现在相机视野中心，避免快速晃动。
• 排查3D模型渲染问题
  1. 检查立方体模型的Layer设置，确保未被相机的Culling Mask排除（默认使用Default层级即可）；
  2. 替换模型材质的Shader为移动端兼容版本，比如Mobile/Unlit/Texture或Standard，避免使用仅支持PC的Shader；
  3. 确认模型缩放比例合理，未因过大/过小超出相机可视范围。
• 查看安卓端日志定位错误
  用数据线连接手机与电脑，执行命令：adb logcat | grep Vuforia，过滤Vuforia相关日志，查看是否存在数据库加载失败、初始化报错或识别异常的信息，这是定位问题最直接的方式。

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