问题起因
最近，项目组的里的同事遇到一个问题，他自己负责的模块，SpringMVC的Controller与其他模块的Controller 类名重名了，导致整个工程都起不来了。
后台报的错误是这样的：
××Controller‘ for bean class [××ontroller] conflicts with existing, non-compatible bean definition of same name and class
午饭时，他一直和我抱怨这个问题，还说找不到办法。
后面我想了一下，SpringMVC的Controller 应该是采用类似键值对(key/value)的映射方式处理的。而当中的键，默认是用cotroller的类名（非全类名）作为键。这样，如果不同包下面的两个Contoller 重名的话，就会导致SpringMVC的容器管理中的controller map中的key重复了。
解决这个问题也比较简单。
在@Controller 中，使用重名名就可以了
如 下例子：
test.controller.bill.BillSaveController
package test.controller.bill;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* Created by liuch on 5/27/15.
*/
@Controller
@RequestMapping("/billsave")
public class BillSaveController {
@RequestMapping("/dosave")
public String saveBill(){
return "billsave";
}
}
及 test.controller.bill.BillSaveController
package test.controller.billsave;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* Created by liuch on 5/27/15.
*/
@Controller
@RequestMapping("/billsave_test")
public class BillSaveController {
@RequestMapping("/test")
public String test(){
return "test";
}
}
上面这两个代码虽然在不同的包下面，即全类名不同，但是类名却是相同。
这样，在Tomcat 启动的时候，后台会报错：
SEVERE: Context initialization failed org.springframework.beans.factory.BeanDefinitionStoreException: Unexpected exception parsing XML document from ServletContext resource [/WEB-INF/dispatcher-servlet.xml]; nested exception is java.lang.IllegalStateException: Annotation-specified bean name ‘billSaveController‘ for bean class [test.controller.billsave.BillSaveController] conflicts with existing, non-compatible bean definition of same name and class [test.controller.bill.BillSaveController]
问题原因：
因为如果在使用注解 @Controller 时候，如果不使用命名，而SpringMVC会默认把类名的头一个字母小写，然后放到一个map中。
比如上面的例子，尽管上面两个类全类名不同，但是他们使用了@Controller 注解的时候，都没有使用命名。在SpringMVC在扫描Controller的时候，会把他们都默认解析为 billSaveController.然后以这个billSaveController为键（key)， 放到一个全局的map中。
这样，就会出现两个键完全一样的Controller。由于SpringMVC不使用覆盖的方式处理具有相同键的不同全类名的Controller,、扫描的时候就会包上面的错误。
解决的办法：
在@Controller上使用名称
如：test.controller.bill.BillSaveController中
package test.controller.bill;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* Created by liuch on 5/27/15.
*/
@Controller("testbillsave")
@RequestMapping("/billsave")
public class BillSaveController {
@RequestMapping("/dosave")
public String saveBill(){
return "billsave";
}
}
test.controller.billsave.BillSaveController中，使用：
package test.controller.billsave;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* Created by liuch on 5/27/15.
*/
@Controller("realbillsave")
@RequestMapping("/billsave_test")
public class BillSaveController {
@RequestMapping("/test")
public String test(){
return "test";
}
}
上面两个Controller中，只要保证一个有命名即可，但是最好两个都使用上。
这是一种良好的编程方式,因为你无法保证其他人不会使用和你一样的类名的Controller。
后记：
下午让同事试了一下，果然可以了。