如何调试Liferay DXP中“No render mappings found”渲染映射错误？

1. 是否遗漏关联步骤？ #

核心映射配置已覆盖，但需排查以下隐性问题：

• 组件激活状态：登录Liferay控制面板→应用程序→模块管理，搜索EditDocumentMVCRenderCommand，确认组件处于ACTIVE状态。若为RESOLVED或其他状态，可能是依赖缺失或代码编译错误。
• 字符串匹配问题：检查MVCCommandNames.EDIT_DOCUMENT定义是否存在多余空格（代码中EDIT_DOCUMENT=后有空格，可能导致编译后字符串带空格，与组件属性值不匹配），建议修正为：public static final String EDIT_DOCUMENT = "/document-management/document/edit";
• Portlet名称一致性：确认javax.portlet.name属性值与Portlet注册名称完全一致，检查liferay-portlet.xml或Portlet类的@Component注解中的名称是否与DocumentsPortletKeys.DOCUMENTS一致。

2. 查看监听URL的方法 #

方法1：Gogo Shell查询 #

1. 访问Liferay Gogo Shell（可通过telnet localhost 11311或控制面板入口）。
2. 执行lb | grep DocumentsPortlet获取模块Bundle ID。
3. 执行inspect service MVCRenderCommand [bundleid]（替换[bundleid]为实际ID），即可查看该模块下所有MVCRenderCommand组件的mvc.command.name和javax.portlet.name属性。

方法2：模块管理界面查询 #

在控制面板→应用程序→模块管理中找到你的模块，点击「查看组件」，筛选MVCRenderCommand类型组件，查看其属性即可获取监听的命令名称。

3. 其他解决建议 #

• 检查部署日志：查看liferay_home/logs/portal.log，确认模块部署时无类加载失败、依赖缺失等报错。
• 清理缓存：删除liferay_home/osgi/state目录下的缓存文件，重启模块或Liferay，同时清理浏览器缓存。
• 简化测试：暂时将mvc.command.name改为简单值（如/edit-document），同步修改JSP中的对应参数，测试是否能正常映射，排除复杂路径的潜在问题。
• 检查RenderCommand实现：确保EditDocumentMVCRenderCommand的render方法无异常抛出，且返回正确的JSP路径（如return "/document/edit.jsp";），方法内部错误也可能导致映射失败的假象。

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