WebSphere Portal部署的新Portlet未显示于应用目录的解决步骤咨询

针对在现有WAR中新增Spring Portlet后，Portal后台无法看到新Portlet的问题，需执行以下操作：

1. 重新注册Portlet应用到Portal #

WebSphere Portal不会自动检测WAR中新增的Portlet定义，需手动完成注册：

• 登录Portal管理控制台，进入应用程序 > WebSphere企业应用程序
• 找到目标WAR应用，点击更新，选择完全替换应用程序，重新上传更新后的WAR包完成更新
• 进入门户网站 > 管理门户网站 > 应用程序 > Portlet管理
• 点击注册Portlet应用程序，选中你的WAR应用执行注册操作

2. 验证Portlet定义的完整性 #

确保portlet.xml配置无遗漏：

• 检查新Portlet的<portlet>节点，确认包含完整的<portlet-name>、<display-name>、<portlet-class>（即org.springframework.web.portlet.DispatcherPortlet）
• 确认<init-param>中正确指定Spring配置文件路径，示例：

  <init-param>
      <name>contextConfigLocation</name>
      <value>/WEB-INF/NewAccountInfo-portlet.xml</value>
  </init-param>
  

• 检查portlet.xml语法符合JSR规范，无XML格式错误

3. 清理Portal缓存并重启组件 #

Portal缓存可能保留旧应用元数据，需清理刷新：

• 进入门户网站 > 管理门户网站 > 门户设置 > 缓存管理
• 清理Portlet定义缓存和应用程序缓存
• 可选：重启Portal服务器（或对应WebSphere应用服务器实例），确保新配置完全加载

4. 检查Portlet权限与状态 #

新Portlet可能因权限或状态限制不可见：

• 进入门户网站 > 管理门户网站 > 应用程序 > Portlet管理，找到新注册的Portlet
• 检查权限设置，确保管理账号拥有查看和添加该Portlet的权限
• 确认Portlet状态为“已启用”，未被禁用

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