Liferay 7.3.5为新用户分配仪表盘出错求助

问题概述 #

使用Liferay 7.3.5版本，现有600+用户使用个人仪表盘。此前通过代码自动为新用户分配用户配置文件与仪表盘，近期出现异常：新用户配置文件可正常分配，但「配置文件与仪表盘」页签显示「该用户无任何私有页面」。测试发现：

• 多种模板分配均失败；
• 仅完全清空模板恢复初始状态时可正常分配；
• 故障前已分配仪表盘的用户使用正常；
• 错误日志提示找不到FileEntry ID 884352，无法追溯该ID，也无法重建全新仪表盘：

2022-05-27 13:51:38.335 ERROR [http-nio-8080-exec-12][SitesImpl:1927] Unable to export layout set prototype 207822
    com.liferay.exportimport.kernel.lar.PortletDataException: No FileEntry exists with the key {fileEntryId=884352}

解决步骤 #

1. 排查Layout Set Prototype关联的无效FileEntry #

日志中提到的layout set prototype 207822是故障核心，该原型的导出流程依赖已被删除的FileEntry 884352：

• 登录Liferay后台，进入控制面板 → 站点 → 站点模板，找到ID为207822的站点模板（即Layout Set Prototype）；
• 检查该模板下所有页面的Portlet，尤其是文档库类Portlet，确认是否有引用已删除的文件；
• 若找到对应Portlet，移除无效文件引用或替换为存在的文件。

2. 数据库层面清理无效关联 #

如果后台无法定位无效引用，直接通过数据库操作处理：

• 连接Liferay数据库，执行查询定位关联记录：

SELECT * FROM LayoutSetPrototype WHERE layoutSetPrototypeId = 207822;
SELECT * FROM PortletPreferences WHERE preferences LIKE '%884352%';
SELECT * FROM ExportImportConfiguration WHERE layoutSetPrototypeId = 207822;

• 备份数据库后，删除或更新包含fileEntryId=884352的无效记录；
• 重启Liferay服务，重新测试仪表盘分配。

3. 重新生成Layout Set Prototype #

若上述操作无效，尝试重建原型：

• 备份当前故障原型的页面结构、Portlet配置信息；
• 删除故障的Layout Set Prototype（ID 207822）；
• 新建空白站点模板，逐步还原之前的页面和Portlet配置，确保所有引用的资源都存在；
• 更新自动分配代码，指向新的Layout Set Prototype ID；
• 测试新用户分配流程。

4. 排查自动分配代码逻辑 #

检查此前的自动分配代码，确认是否存在以下问题：

• 代码中是否硬编码了FileEntry ID，导致引用已删除的资源；
• 分配流程中是否未处理FileEntry不存在的异常，导致仪表盘创建中断；
• 确保代码在分配前调用LayoutSetPrototypeLocalService.validateExport()验证原型完整性。

5. 清理Liferay缓存 #

操作完成后，清理缓存确保变更生效：

• 进入控制面板 → 服务器 → 缓存，清除所有缓存；
• 或直接删除部署目录下的osgi/state和work文件夹，重启服务。

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