Spring项目报错：无法找到org.apache.commons.dbcp.BasicDataSource类

我之前也碰到过一模一样的问题，给你几个排查和解决的方向，按顺序试应该能搞定：

1. 确认Maven依赖是否真的下载到本地仓库 #

首先去你的本地Maven仓库（默认路径是~/.m2/repository/commons-dbcp/commons-dbcp/1.4/），检查是否存在commons-dbcp-1.4.jar文件。如果没有，说明依赖没拉取成功，执行下面的Maven命令强制更新：

mvn clean install -U

-U参数会强制Maven更新所有快照和发布版依赖，确保jar包被正确下载。

2. 同步Eclipse与Maven依赖 #

有时候Maven已经下载了依赖，但Eclipse没同步过来：

• 右键你的项目 → Maven → Update Project
• 在弹出的窗口里勾选Force Update of Snapshots/Releases，然后点击OK

如果还是不行，试试重新导入项目：

• 先在Eclipse里删除项目（不要勾选"Delete project contents on disk"）
• 然后通过Import → Existing Maven Projects重新导入你的项目，让Eclipse重新解析依赖

3. 检查Build Path是否包含该依赖 #

右键项目 → Build Path → Configure Build Path，切换到Libraries标签页，展开Maven Dependencies，看看有没有commons-dbcp-1.4.jar。如果没有，可能是Maven依赖没被正确加入Build Path，试试执行：

mvn eclipse:eclipse

然后再刷新项目。

4. 清理Eclipse缓存 #

Eclipse的缓存偶尔会导致奇怪的类找不到问题：

• 点击Window → Preferences → General → Workspace，点击**Clean...**清理工作区缓存
• 或者直接重启Eclipse，极端情况下可以备份工作区后删除.metadata文件夹（注意：这个操作会重置Eclipse的工作区设置，谨慎操作）

5. 尝试切换到Commons DBCP 2（可选） #

如果上述方法都无效，建议换成更现代的Commons DBCP 2版本，它的兼容性更好，类路径也有变化：
修改pom.xml中的依赖：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-dbcp2</artifactId>
    <version>2.9.0</version>
</dependency>

然后修改beans-cp.xml中的类路径：

<bean id="ds" class="org.apache.commons.dbcp2.BasicDataSource">
    <!-- 其他属性保持不变 -->
</bean>

附：你的配置代码 #

出现错误的beans-cp.xml：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd">
<bean id="ds" class="org.apache.commons.dbcp.BasicDataSource">
<property name="username" value="${jdbc.username}"></property>
<property name="password" value="${jdbc.password}"></property>
<property name="driverClassName" value="${jdbc.driverClassName}">
</property>
<property name="url" value="${jdbc.url}"></property>
</bean>
</beans>

你的pom.xml配置：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.timbuchalka</groupId>
<artifactId>spring-jdbc-template-demo-1</artifactId>
<version>0.0.1-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>4.3.7.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.3.7.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>4.3.7.RELEASE</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>6.0.6</version>
</dependency>
<dependency>
<groupId>commons-dbcp</groupId>
<artifactId>commons-dbcp</artifactId>
<version>1.4</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>4.3.7.RELEASE</version>
</dependency>
</dependencies>
</project>

内容的提问来源于stack exchange，提问作者Ivan Bošnjaković