如何在Liferay中覆盖login.jsp？求可行方案与报错解决

既然你已经写好自定义的login.jsp和登录逻辑，Fragment模块覆盖是最贴合需求的方案——官方明确login.jsp属于模块JSP，允许使用Fragment方案（核心JSP不建议，但模块JSP不受此限制）。

先解决Fragment创建报错问题 #

检查这几个关键配置：

• 修正gradle.properties里的路径格式：Windows系统下用双反斜杠或正斜杠，不要加引号，示例：

  liferay.workspace.home.dir = C:\\Users\\thisPC\\Desktop\\Liferay\\liferay-ce-portal-7.1.2-ga3
  

• 创建Fragment时，目标模块选择com.liferay.login.web，版本范围要匹配你的Liferay 7.1.2 GA3（对应模块版本为2.x，比如com.liferay.login.web-2.0.24.jar，可从Liferay安装目录的osgi/modules下查看）。

完整实现步骤示例 #

1. 创建Fragment模块 #

• 在Liferay Workspace中新建Module Project，类型选择Fragment。
• 填写目标模块为com.liferay.login.web，版本范围设为[2.0.0,3.0.0)（适配7.1.x版本）。

2. 放置自定义login.jsp #

在Fragment模块的src/main/resources/META-INF/resources目录下，直接放入你写好的login.jsp——原模块的login.jsp路径就是META-INF/resources/login.jsp，保持路径一致即可覆盖。

3. 配置bnd.bnd文件 #

确保bnd文件包含以下核心配置：

Bundle-Name: Custom Login Fragment
Bundle-SymbolicName: com.yourcompany.login.fragment
Bundle-Version: 1.0.0
Fragment-Host: com.liferay.login.web;bundle-version="[2.0.0,3.0.0)"
Liferay-Require-SchemaVersion: 1.0.0

Fragment-Host的版本范围要和你环境中com.liferay.login.web的实际版本匹配。

4. 部署模块 #

执行Gradle部署命令：

• Windows：gradlew.bat deploy
• Linux/Mac：./gradlew deploy
  部署完成后，重启Liferay或通过Gogo shell刷新模块。

验证效果 #

访问登录页面，即可看到自定义的login.jsp生效。

临时测试备选方案（不推荐生产用） #

如果只是临时验证自定义JSP，可以直接找到Liferay安装目录下osgi/modules/com.liferay.login.web-xxx.jar，解压后替换其中的META-INF/resources/login.jsp，重新打包成jar放回原目录。但这种方式在Liferay升级、重启后可能失效，仅适合临时测试。

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