WebLogic共享库引用问题求助：部署后控制台未识别引用关系

我来帮你梳理下正确配置共享库并让应用成功引用的步骤，以及排查控制台不显示引用的常见问题：

一、先确保共享库部署符合规范 #

你的sample.ear要作为共享库正常工作，必须先配置好共享库标识：

• 在sample.ear的META-INF/weblogic-application.xml文件中，添加共享库的核心配置，示例如下：

  <weblogic-application xmlns="http://xmlns.oracle.com/weblogic/weblogic-application">
    <!-- 可选：设置共享库的上下文根 -->
    <library-context-root>/sample-lib</library-context-root>
    <!-- 必填：共享库的唯一名称 -->
    <library-name>SampleSharedLibrary</library-name>
    <!-- 必填：共享库的版本号 -->
    <library-version>1.0.0</library-version>
  </weblogic-application>
  

• 部署时必须在WebLogic控制台明确选择部署为共享库，而不是普通应用程序。

二、让应用程序正确引用共享库 #

要让你的目标应用（不管是另一个EAR还是WAR）关联这个共享库，需要在应用的配置文件中添加引用：

• 如果是EAR应用，修改META-INF/weblogic-application.xml；如果是WAR应用，修改META-INF/weblogic.xml，添加如下配置：

  <weblogic-application xmlns="http://xmlns.oracle.com/weblogic/weblogic-application">
    <library-ref>
      <!-- 必须和共享库的library-name完全一致 -->
      <library-name>SampleSharedLibrary</library-name>
      <!-- 必须和共享库的library-version匹配，也可以用范围或设置exact-match为false放宽匹配 -->
      <library-version>1.0.0</library-version>
      <!-- 可选：是否要求精确版本匹配，默认是true -->
      <exact-match>false</exact-match>
    </library-ref>
  </weblogic-application>
  

• 部署顺序注意：先部署共享库，再部署引用它的应用；如果已经部署了应用，需要重新部署应用让配置生效。

三、排查控制台不显示引用的常见问题 #

如果配置完还是看不到引用，试试这些排查点：

• 检查名称和版本的匹配度：WebLogic对library-name和library-version是大小写敏感的，哪怕多一个点（比如1.0 vs 1.0.0）都会导致匹配失败，务必完全一致。
• 查看应用启动日志：如果应用启动时找不到共享库，会在domain_home/servers/[你的服务器名]/logs/[你的服务器名].log中报错，这种情况下引用不会被记录，先解决启动错误。
• 确认控制台查看路径正确：进入共享库的详情页面，找到“引用此库的应用程序”模块，注意有没有部署多个同名不同版本的共享库，别查错了实例。
• 重启相关组件：有时候缓存或部署顺序问题会导致引用不显示，尝试先停止共享库，再停止应用，然后重新部署共享库，最后部署应用。

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