UEVR项目中的日志级别优化与调整

背景介绍

在UEVR(Unreal Engine VR)项目中，默认的日志级别设置为INFO级别，这在实际游戏运行过程中可能会产生大量重复的日志信息。这些日志不仅占用磁盘空间，还可能影响性能，同时使得开发者难以从海量日志中快速定位真正重要的信息。

问题分析

通过项目维护者的观察，发现几个典型的日志重复输出场景：

1. UI目标缺失警告：系统会持续输出"No UI target, skipping!"的INFO级别日志，这在某些游戏中会以极高的频率出现。

2. 纹理上下文创建信息：在Jedi Fallen Order等游戏的主菜单界面，系统会重复输出关于纹理上下文创建的详细信息。

3. 交换链纹理获取提示：在MechWarrior等游戏中，系统会频繁提示"Already acquired textures for swapchain"的信息。

4. 未知事件记录：系统会记录所有未知的VR事件(如"Unknown event: 1700")，这些事件可能并不总是需要关注。

技术解决方案

针对这些问题，项目采取了以下改进措施：

1. 引入周期性日志输出：对于高频重复的日志信息，如"No UI target"警告，改用SPDLOG_INFO_EVERY_N_SEC宏，确保相同信息不会在短时间内重复输出。

2. 区分日志级别：将初始化阶段的扫描信息保留为INFO级别，因为这些信息对于诊断扫描问题很有价值；而将运行时的重复性信息调整为WARNING或DEBUG级别。

3. 增加日志级别配置：在UI界面中添加日志级别选择功能，允许用户根据需求动态调整日志级别，从DEBUG到ERROR不等。

4. 修复潜在问题：对于某些看似日志问题实则反映潜在功能问题的场景(如MechWarrior中的交换链纹理获取提示)，进行深入调查和修复。

实现细节

日志系统的优化主要涉及以下几个方面：

1. 日志级别分类：

   • DEBUG：详细调试信息
   • INFO：重要运行信息(默认级别)
   • WARNING：潜在问题警告
   • ERROR：严重错误

2. 周期性日志控制：通过封装宏实现，确保相同日志信息不会在短时间内重复输出，同时仍保留关键信息。

3. UI集成：在配置界面添加下拉菜单，允许用户实时调整日志级别，无需重启应用即可生效。

最佳实践建议

1. 开发阶段：建议使用DEBUG或INFO级别，以便获取详细的运行信息。

2. 测试阶段：可调整为WARNING级别，重点关注潜在问题。

3. 生产环境：推荐使用WARNING或ERROR级别，减少日志量并聚焦关键问题。

4. 性能敏感场景：对于高频调用的代码路径，应谨慎使用日志，或使用周期性日志输出策略。

总结

通过优化UEVR项目的日志系统，不仅解决了日志过载的问题，还提高了系统的可维护性和用户体验。合理的日志级别设置和输出策略是大型项目开发中的重要考量因素，能够有效平衡调试需求和运行效率。