Liferay 7.3.5 WAR文件部署及多主题冲突问题求助

问题概述 #

在Liferay 7.3.5中部署主题时遇到两类核心问题：

• 将主题WAR放入deploy文件夹后，文件消失但无部署反应
• 手动放入WAR文件夹后，单个主题可运行，但部署第二个主题后，第一个主题出现CSS失效、系统编辑菜单消失等异常，且主题无缩略图

问题根源 #

手动操作WAR文件夹破坏了Liferay的部署管理机制，多主题的配置标识或资源路径冲突导致样式覆盖，服务器启动时未正确加载主题资源。

正确部署流程（推荐使用deploy文件夹） #

1. 确保服务器处于运行状态
   Liferay的deploy文件夹监听机制仅在服务器启动时生效，文件放入后会自动触发部署，若无反应需查看logs/liferay.*.log日志，排查依赖缺失、主题配置错误等问题。

2. 规范主题打包

   • 每个主题的liferay-look-and-feel.xml必须配置唯一的id和name，避免标识冲突
   • 使用Liferay官方主题工具（如liferay-theme-generator）打包，保证目录结构符合规范
   • 主题资源路径使用Liferay内置变量（如$theme_folder），禁止硬编码路径

3. 多主题部署步骤

   • 停止服务器，清理osgi/war、osgi/state目录下的主题相关文件，同时清除data/document_library中的缓存资源
   • 启动服务器，将主题WAR逐个放入deploy文件夹，等待每个主题部署完成（日志提示“Successfully deployed”）后，再放入下一个
   • 部署完成后，进入站点设置重新选择对应主题并发布站点

异常修复与排查 #

• 无缩略图：检查主题根目录是否包含thumbnail.png（尺寸建议120x90px），打包时确保该文件被纳入WAR包
• CSS失效/菜单消失：打开浏览器控制台查看资源加载错误，确认主题CSS路径是否正确；检查主题样式是否使用全局选择器（如*）覆盖了Liferay系统默认样式
• deploy文件夹无反应：验证WAR包是否完整，检查日志中是否有“Invalid WAR file”或依赖缺失的报错信息

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