Liferay DXP 7.4.13-u76模块片段重写Portlet方法失败求助

核心问题分析 #

1. OSGi组件注解不继承
   父类SearchResultsPortlet的@Component注解不会被子类自动继承，因此你的CustomPortlet必须显式添加@Component注解并配置正确属性，才能被OSGi容器识别并注册。

2. 模块片段的用途限制
   你当前使用的模块片段（Fragment Module）仅支持修改目标模块的静态资源（如JSP、配置文件），无法用来重写或替换Java类。要实现Portlet方法的重写，必须创建独立的OSGi模块，通过组件属性替换原Portlet。

正确实现步骤 #

1. 调整模块类型

放弃模块片段，创建一个普通的OSGi模块（Maven或Gradle构建均可）。

2. 配置子类的@Component注解

你的CustomPortlet类必须添加完整的@Component配置，关键属性需与原SearchResultsPortlet匹配，确保OSGi优先加载你的组件：

import com.liferay.portlet.search.SearchResultsPortlet;
import javax.portlet.Portlet;
import javax.portlet.RenderRequest;
import javax.portlet.RenderResponse;
import javax.portlet.PortletException;
import org.osgi.service.component.annotations.Component;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.io.IOException;

@Component(
    property = {
        "com.liferay.portlet.display-category=category.search",
        "com.liferay.portlet.instanceable=false",
        "javax.portlet.name=com_liferay_portlet_search_SearchResultsPortlet", // 必须与原Portlet的端口名完全一致
        "javax.portlet.display-name=Custom Search Results",
        "service.ranking:Integer=100" // 设置更高优先级，确保覆盖原组件
    },
    service = Portlet.class
)
public class CustomPortlet extends SearchResultsPortlet {
    private static final Logger log = LoggerFactory.getLogger(CustomPortlet.class);

    @Override
    public void render(RenderRequest renderRequest, RenderResponse renderResponse) throws IOException, PortletException {
        log.info("Overridden render method executed");
        System.out.println("Overridden render method executed");
        super.render(renderRequest, renderResponse);
    }
}

注：javax.portlet.name的取值需与原SearchResultsPortlet组件的对应属性完全一致。你可以通过Gogo Shell命令inspect cap com.liferay.portlet.search查看原组件的属性值进行确认。

3. 配置模块依赖

在模块的bnd.bnd文件中添加必要的依赖：

Bundle-SymbolicName=com.yourcompany.custom.search.results.portlet
Bundle-Version=1.0.0
Import-Package=\
    com.liferay.portlet.search,\
    javax.portlet,\
    org.osgi.service.component.annotations,\
    org.slf4j

4. 验证组件注册

部署模块后，通过Gogo Shell执行以下命令验证组件状态：

scr:list | grep CustomPortlet

如果输出显示组件状态为ACTIVE，则说明注册成功；若失败，查看模块日志排查依赖缺失或属性配置错误。

补充说明 #

你之前修改JSP生效是因为模块片段支持静态资源的修改，但Java类的重写必须通过独立OSGi模块+组件替换的方式实现。

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