JBoss 5迁移到WildFly 21时JNDI命名绑定配置异常求解

WildFly 对自定义JNDI绑定做了命名空间限制，所有自定义绑定默认需要归属java:/、java:jboss/这类内置命名空间下，无命名空间前缀的裸名绑定默认不被识别，这是出现NameNotFoundException的核心原因。

基础配置方式 #

方式1：直接修改standalone.xml #

找到naming子系统的<bindings>节点，添加如下配置：

<subsystem xmlns="urn:jboss:domain:naming:2.0">
  <bindings>
    <simple name="java:/banana/properties/myFile" value="/你的/配置文件/绝对路径" type="java.lang.String"/>
  </bindings>
  <remote-naming/>
</subsystem>

修改后重启WildFly即可生效，此时可以通过new InitialContext().lookup("java:/banana/properties/myFile")读取到对应值。

方式2：通过jboss-cli命令行配置（更推荐，避免配置文件格式错误） #

启动WildFly后执行以下命令：

• 连接WildFly实例：connect
• 添加JNDI绑定：/subsystem=naming/binding=java\:\/banana\/properties\/myFile:add(binding-type=simple, value="/你的/配置文件/绝对路径", type="java.lang.String")
• 重载配置生效：reload

兼容原有代码无需修改lookup路径的方案 #

如果不想改动原有Java代码的lookup逻辑，可以通过以下两种方式实现兼容：

方案A：应用部署描述符添加映射 #

如果是Web应用，在项目的WEB-INF/jboss-web.xml中添加资源引用映射：

<jboss-web>
  <resource-env-ref>
    <resource-env-ref-name>banana/properties/myFile</resource-env-ref-name>
    <jndi-name>java:/banana/properties/myFile</jndi-name>
  </resource-env-ref>
</jboss-web>

如果是EJB应用，在META-INF/jboss-ejb3.xml中添加对应映射规则即可。

方案B：调整InitialContext初始化参数 #

初始化上下文时指定默认命名空间前缀：

Properties env = new Properties();
env.put(Context.INITIAL_CONTEXT_FACTORY, "org.wildfly.naming.client.WildFlyInitialContextFactory");
env.put("jboss.naming.client.default.namespace", "java:/");
InitialContext ctx = new InitialContext(env);
String configPath = (String) ctx.lookup("banana/properties/myFile");

常见排查点 #

• 绑定的type属性需要和值的类型匹配，本次存储的是文件路径字符串，需指定为java.lang.String
• 如需要外部客户端跨进程访问该JNDI项，绑定名称需使用java:jboss/exported/前缀，例如java:jboss/exported/banana/properties/myFile
• 可通过jboss-cli执行/subsystem=naming/binding=java\:\/banana\/properties\/myFile:read-resource验证配置是否正确加载

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