Skip to main content
Linux 平台使用与 Windows 相同的 C++ API,大部分错误处理逻辑一致。本文额外列出 Linux 特有的问题。

返回值约定

BeautyEffectEngine::Create() 失败时返回 nullptr

常见错误与处理

1. 引擎创建失败(Create 返回 nullptr

参考原因与解决方式与 Windows 一致,请先开启日志定位:
常见原因app_id / app_key 无效、resource.fbd 路径错误、网络不通。

2. libfacebetter.so 运行时加载失败

错误信息
解决方法(三选一):

3. ProcessImage 返回 nullptr


4. 美颜效果不生效

确认每个 BeautyType 已启用,且参数值大于 0

5. GLFW 无法打开显示器

错误信息
解决方法

6. OpenGL 初始化失败

可能原因:系统缺少 OpenGL 驱动或 Mesa 库。 解决方法

日志调试


错误码速查