无`@Named('dpa')`却遭Resin报重复命名错误的原因与解决

云上老周

2026-5-19

解决Resin 4.0.55中CDI @Named重复名称错误的实战指南

错误含义解析

首先，这个@Named('dpa') is a duplicate name错误的核心意思是：Resin的CDI容器在初始化时，发现有两个或多个Bean共享了dpa这个命名标识，容器无法区分它们，因此抛出冲突异常。你说源码里没有显式写@Named("dpa")，那问题十有八九出在Resin内部组件、第三方依赖或者CDI的隐式命名规则上。

可能的成因

CDI隐式命名冲突：CDI对没有显式添加@Named注解的Bean，会默认使用类名的小写形式作为Bean名称。如果你的代码里有一个名为Dpa（或DPA）的类，它的隐式命名就是dpa，刚好和Resin内部注册的某个同名Bean撞了。
Resin内置组件自动注册：Resin开源版默认启用了一些和持久化、数据源相关的内部模块（比如它的DPA，Data Persistence API），这些模块会自动向CDI容器注册名为dpa的Bean，和你的应用Bean产生冲突。
Resin CDI实现的旧版本bug：Resin 4.0.55是2018年左右的版本，它的CDI实现可能存在扫描逻辑的bug，误将某些非CDI组件识别为带@Named("dpa")的Bean，或者在处理配置属性注入时生成了重复命名。
第三方依赖的隐性注册：你的项目依赖的某个库（比如持久化框架、配置工具）在Resin环境下会自动注册dpa命名的Bean，导致冲突。

分步解决方法

1. 排查并修正隐式命名的Bean

先扫一遍你的代码，看看有没有类名为Dpa/DPA的类。如果有，给它显式添加一个唯一的@Named注解，比如：

@Named("myAppDpaService")
public class Dpa {
    // ... 你的代码
}

这样就能避开默认的dpa命名冲突。

2. 禁用Resin的DPA模块

如果是Resin内置的DPA组件搞的鬼，可以在你的web应用的resin-web.xml（如果没有就新建一个，放在WEB-INF下）里添加配置禁用它：

<web-app xmlns="http://caucho.com/ns/resin">
    <!-- 关闭Resin自动注册的DPA相关Bean -->
    <dpa:init disable="true"/>
    <!-- 或者更精准地排除DPA包的CDI扫描 -->
    <cdi:scan>
        <exclude name="com.caucho.dpa.*"/>
    </cdi:scan>
</web-app>

3. 开启CDI debug日志定位根源

如果上面的方法没解决，建议开启Resin的CDI debug日志，看看到底是哪个Bean在注册dpa名称。修改Resin主配置文件resin.xml，添加日志配置：

<log-handler name="cdi-debug" level="finest">
    <formatter type="pattern" pattern="%d{yyyy-MM-dd HH:mm:ss} %p %c: %m%n"/>
    <file path="logs/cdi-debug.log"/>
</log-handler>
<logger name="com.caucho.webbeans" level="finest" handler="cdi-debug"/>

启动Resin后，查看cdi-debug.log，搜索dpa关键词，就能找到注册这个命名的Bean的全类名和来源，精准定位问题。

4. 显式指定配置属性的生产者命名

如果你是通过@Produces来注入配置字符串的，确保每个生产者都显式指定唯一的@Named名称，避免默认命名冲突。比如：

@Produces
@Named("myDpaConfigValue")
public String getDpaConfig(@Inject @Configuration("dpa.config") String config) {
    return config;
}

5. 升级Resin版本

Resin 4.0.55确实比较老旧，很多CDI相关的bug在后续版本中已经修复。尝试升级到Resin 4.0的最新稳定版（比如4.0.75），大概率能解决这个兼容性问题。

额外提示

如果你的应用是严格基于Java EE 7 Web Profile开发的，Resin开源版的实现和规范可能存在一些偏差，遇到这类兼容性问题时，优先查看Resin官方文档中关于CDI的特殊配置说明，或者对比TomEE/Glassfish的CDI行为差异来调整。

内容的提问来源于stack exchange，提问作者Thorbjørn Ravn Andersen