Liferay下Spring Portlet用@RenderMapping返回外部URL跳转失败如何解决

问题根因 #

你当前的写法存在两个核心问题：

• Spring Portlet的redirect:前缀默认遵循Portlet容器内部跳转规则，会自动拼接Portal路径前缀，不会直接跳转外部地址
• Render阶段直接设置HTTP 302和Location头会被Liferay的Portal渲染管道拦截，不会直接透传给前端浏览器

可行解决方案 #

方案1：改用Resource请求处理跳转逻辑 #

把跳转逻辑从@RenderMapping移到@ResourceMapping方法中，Resource请求的响应可以直接透传HTTP头给浏览器，不会被Portal拦截

@ResourceMapping("redirectToExternal")
public void redirectToExternal(ResourceRequest request, ResourceResponse response) throws Exception {
    // 先执行业务逻辑
    doYourBusinessLogic();
    // 直接设置302和Location头
    response.setProperty(ResourceResponse.HTTP_STATUS_CODE, String.valueOf(HttpServletResponse.SC_MOVED_TEMPORARILY));
    String redirectUrl = "https://你的外部地址";
    response.setProperty("Location", redirectUrl);
}

前端触发请求的链接指向该Resource请求地址，设置target="_blank"即可实现新标签页跳转

方案2：Render阶段返回前端跳转脚本 #

如果不想修改请求类型，可以在Render阶段返回专用跳转视图，通过前端JS直接跳出Portal上下文：

• 后端逻辑调整：执行业务逻辑后把外部跳转地址存入Model，不直接返回redirect

@RenderMapping
public String view(Model model, PortletRequest request, PortletResponse response) throws Exception {
    // 执行业务逻辑判断是否需要跳转
    if (needRedirect()) {
        model.addAttribute("externalRedirectUrl", "https://你的外部地址");
        return "redirect-view"; // 返回自定义的跳转视图
    }
    // 正常视图逻辑
    return "normal-view";
}

• redirect-view视图插入跳转代码：

<script type="text/javascript">
    // 新标签页打开场景直接用window.location.href即可
    window.location.href = '${externalRedirectUrl}';
</script>

方案3：使用Liferay原生重定向工具类 #

Liferay提供的PortalUtil.sendRedirect工具方法会自动处理Portlet上下文的跳转限制，原生支持外部地址跳转：

import com.liferay.portal.kernel.util.PortalUtil;

@RenderMapping
public String view(Model model, PortletRequest request, PortletResponse response) throws Exception {
    // 执行业务逻辑
    doYourBusinessLogic();
    String redirectUrl = "https://你的外部地址";
    PortalUtil.sendRedirect(PortalUtil.getHttpServletResponse(response), redirectUrl);
    return null; // 不需要再返回视图
}

注意：如果需要新标签页打开跳转，要确保触发请求的链接/按钮设置了target="_blank"属性，否则跳转只会在当前Portlet容器内生效。

内容的提问来源于stack exchange，提问作者M.R.