Liferay 7.0迁移至7.4后外观配置弹窗空白问题求助

1. 优先查看控制台错误日志 #

直接打开Liferay的日志文件（如tomcat/logs/localhost.log或后台日志工具），重点找点击外观配置时出现的报错信息——比如JS加载失败、组件初始化异常、权限校验错误，这些日志能快速定位问题根源。

2. 核验Portlet配置权限 #

• 确认管理员账号权限：进入「控制面板→角色→管理员→权限」，找到对应Portlet的权限项，确保勾选了配置权限。
• 检查Portlet配置文件：查看自定义Portlet的liferay-portlet.xml，确认<configuration-action-class>指向的配置类正确，且Portlet本身实现了外观配置的逻辑（部分旧版自定义Portlet可能未适配7.4的配置规范）。

3. 清理缓存并重建资源 #

• 清理Liferay后台缓存：进入「控制面板→服务器→缓存管理」，清空所有缓存（包括主题、Portlet、资源缓存）。
• 重建主题资源：自定义主题需重新运行gulp build编译后部署；官方经典主题可尝试重新部署7.4版本的主题包。
• 强制刷新浏览器：用Ctrl+Shift+R清除浏览器缓存，避免旧资源干扰配置窗口加载。

4. 确认portal-ext.properties配置生效 #

• 检查look.and.feel.modifiable=true是否生效：重启Liferay后，进入「控制面板→系统设置→基础配置→外观」，查看是否显示“允许修改外观”选项，确认配置已被加载。
• 排查冲突配置：比如layout.template.cache.enabled=true可能影响窗口渲染，可临时设为false测试是否解决问题。

5. 排查FTL模板问题 #

• 检查自定义主题的FTL文件：查看portal_normal.ftl或portlet.ftl，确认没有误删${portlet_configuration}相关标签，也没有修改模态窗口样式导致内容被隐藏。
• 对比官方模板：将自定义主题的FTL文件和7.4官方经典主题的对应文件对比，修复差异点。

6. 验证Portlet兼容性 #

7.0到7.4的Portlet API有版本迭代（如从Portlet 2.0到3.0），需确认自定义Portlet的配置类适配7.4的接口规范，比如ConfigurationAction的方法签名是否符合新版本要求。

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