LibrePCB在Alpine Linux下文本显示异常与单元测试崩溃问题分析

问题背景

在Alpine Linux环境下构建和运行LibrePCB 1.2.0版本时，用户遇到了两个主要的技术问题：一是原理图编辑器中几乎不显示任何文本内容（仅显示网络名称），二是在运行单元测试时出现了一个特定的测试用例崩溃。

文本显示异常问题

现象描述

当在Alpine Linux上运行LibrePCB 1.2.0时，原理图编辑器窗口中的大部分文本内容都无法显示，包括元件标识符、参数值等重要信息。有趣的是，导出为PDF或图片的功能却能正确显示所有文本内容。

根本原因

经过开发团队调查，这个问题源于Qt 6.8.0版本中存在的一个已知bug。该bug影响了文本渲染功能，导致在图形界面中无法正确显示文本内容。

解决方案

Qt官方已经在6.8.1版本中修复了这个bug。因此，建议Alpine Linux用户：

1. 等待系统仓库更新至Qt 6.8.1或更高版本
2. 或者使用Qt 6.2及以上版本（6.8.0除外）
3. 作为临时解决方案，可以考虑使用XWayland而不是原生Wayland会话

单元测试崩溃问题

问题定位

在运行单元测试时，EagleProjectImportTest.testNodino测试用例会导致程序崩溃。经过深入分析，发现问题出在BoardNetSegmentSplitter类的实现中。

技术细节

BoardNetSegmentSplitter::split()方法调用findConnectedLinesAndPoints时，传递了一个指向availableTraces容器中元素的引用作为参数。随后，findConnectedLinesAndPoints方法在循环中修改了availableTraces容器，导致传入的引用失效，最终引发内存访问违规。

修复方案

开发团队已经提交了修复补丁，主要修改点包括：

1. 避免在修改容器时保持对容器元素的引用
2. 重新设计相关逻辑以确保内存安全
3. 添加必要的安全检查

技术启示

1. 跨平台兼容性：即使代码在多个平台上表现正常，仍可能存在特定环境下的问题，强调了全面测试的重要性。

2. 容器安全性：在C++中操作STL容器时，需要特别注意迭代器失效问题，特别是在循环中修改容器内容时。

3. 依赖管理：第三方库的版本选择可能带来意想不到的问题，建议保持对上游bug的跟踪并及时更新。

用户建议

对于Alpine Linux用户：

1. 建议等待Qt 6.8.1可用后再构建LibrePCB
2. 如果必须立即使用，可以考虑从源代码应用相关修复补丁
3. 关注LibrePCB的后续版本更新，确保获取最新的稳定性改进

这个问题也提醒我们，在嵌入式或特殊Linux发行版上部署应用时，需要更加谨慎地处理依赖关系和平台特性。