RomM项目平台文件夹内嵌ROM目录问题解析

问题现象

在RomM游戏管理平台(v3.5.0-alpha.1版本)中，当用户采用特定目录结构存储游戏ROM文件时，系统会出现无法加载游戏列表的问题。具体表现为：当平台目录(如gba文件夹)内包含子目录(如hacks文件夹)且子目录中存放有ROM文件时，前端页面会返回404错误，同时后端日志显示类型验证失败。

技术背景

RomM是一个游戏ROM管理平台，采用前后端分离架构。后端使用Python开发，基于FastAPI框架，采用Pydantic进行数据验证。平台通过扫描用户指定的ROM库目录结构，将游戏信息存入数据库并提供管理接口。

问题根源分析

该问题源于数据库模型与前端展示模型之间的数据转换异常。具体表现为：

1. 当ROM文件存放在平台主目录时，系统能正常处理
2. 当ROM文件存放在平台目录的子文件夹中时，后端尝试将文件路径信息转换为SimpleRomSchema模型时失败
3. 错误信息表明系统期望获得字典类型数据，但实际接收到的是字符串类型

解决方案

对于使用alpha版本的用户，可以通过执行"快速扫描"功能解决此问题：

1. 进入RomM管理界面
2. 选择扫描菜单
3. 执行快速扫描操作

该操作会重新构建数据库中每个ROM的files列表，修复数据模型不一致的问题。

技术原理

快速扫描功能会：

1. 重新遍历ROM库目录结构
2. 更新数据库中的文件路径信息
3. 确保所有ROM记录都包含完整的文件元数据
4. 重建Pydantic模型所需的数据结构

最佳实践建议

为避免类似问题，建议用户：

1. 在变更ROM库目录结构后执行扫描操作
2. 定期检查数据库与文件系统的同步状态
3. 对于嵌套目录结构，确保使用最新版本的管理工具
4. 关注系统日志中的数据验证警告

该问题的修复体现了RomM项目对复杂目录结构的支持能力正在不断完善，用户在使用过程中遇到类似数据不一致问题时，优先考虑使用系统提供的扫描工具进行修复。