Spring Boot中UserDao类型Bean找不到问题的排查求助

错误信息 #

Parameter 0 of constructor in com.example.demo.service.UserServiceImpl required a 
bean of type 'com.example.demo.dao.UserDao' that could not be found.

Action:

Consider defining a bean of type 'com.example.demo.dao.UserDao' in your configuration.

项目文件 #

UserController.java #

package com.example.demo.controller;

import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/users")
public class UserController {

    @Autowired
    private final UserService userService;
    
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping("/{userId}")
    public User getUserById(@PathVariable Long userId) {
        return userService.getUserById(userId);
    }

    @GetMapping
    public List<User> getAllUsers() {
        return userService.getAllUsers();
    }

    @PostMapping
    public Long addUser(@RequestBody User user) {
        return userService.addUser(user);
    }

    @PutMapping("/{userId}")
    public void updateUser(@PathVariable Long userId, @RequestBody User user) {
        user.setUserId(userId);
        userService.updateUser(user);
    }

    @DeleteMapping("/{userId}")
    public void deleteUser(@PathVariable Long userId) {
        userService.deleteUser(userId);
    }
}

UserService.java #

package com.example.demo.service;

import com.example.demo.model.User;
import org.springframework.stereotype.Component;
import org.springframework.stereotype.Service;

import java.util.List;

public interface UserService {
    User getUserById(Long userId);

    List<User> getAllUsers();

    Long addUser(User user);

    void updateUser(User user);

    void deleteUser(Long userId);
}

UserServiceImpl.java #

package com.example.demo.service;

import com.example.demo.dao.UserDao;
import com.example.demo.model.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserServiceImpl implements UserService {
    
    private final UserDao userDao;

    @Autowired
    public UserServiceImpl(UserDao userDao) {
        this.userDao = userDao;
    }

    @Override
    public User getUserById(Long userId) {
        return userDao.getUserById(userId);
    }

    @Override
    public List<User> getAllUsers() {
        return userDao.getAllUsers();
    }

    @Override
    public Long addUser(User user) {
        return userDao.addUser(user);
    }

    @Override
    public void updateUser(User user) {
        userDao.updateUser(user);
    }

    @Override
    public void deleteUser(Long userId) {
        userDao.deleteUser(userId);
    }
}

UserDaoImpl.java #

package com.example.demo.dao;

import com.example.demo.model.User;
import org.springframework.jdbc.core.BeanPropertyRowMapper;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository
public class UserDaoImpl implements UserDao {

    private final JdbcTemplate jdbcTemplate;

    public UserDaoImpl(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    @Override
    public User getUserById(Long userId) {
        String sql = "SELECT * FROM user WHERE user_id = ?";
        return jdbcTemplate.queryForObject(sql, new Object[]{userId}, new BeanPropertyRowMapper<>(User.class));
    }

    @Override
    public List<User> getAllUsers() {
        String sql = "SELECT * FROM user";
        return jdbcTemplate.query(sql, new BeanPropertyRowMapper<>(User.class));
    }

    @Override
    public Long addUser(User user) {
        String sql = "INSERT INTO user (first_name, last_name, email, user_avatar_url, podcast_id) " +
                "VALUES (?, ?, ?, ?, ?)";
        jdbcTemplate.update(sql, user.getFirstName(), user.getLastName(), user.getEmail(),
                user.getUserAvatarUrl(), user.getPodcastId());

        // Retrieve the auto-generated user_id
        return jdbcTemplate.queryForObject("SELECT 604822", Long.class);
    }

    @Override
    public void updateUser(User user) {
        String sql = "UPDATE user SET first_name = ?, last_name = ?, email = ?, " +
                "user_avatar_url = ?, podcast_id = ? WHERE user_id = ?";
        jdbcTemplate.update(sql, user.getFirstName(), user.getLastName(), user.getEmail(),
                user.getUserAvatarUrl(), user.getPodcastId(), user.getUserId());
    }

    @Override
    public void deleteUser(Long userId) {
        String sql = "DELETE FROM user WHERE user_id = ?";
        jdbcTemplate.update(sql, userId);
    }
}

UserDao.java #

package com.example.demo.dao;
import com.example.demo.model.User;

import java.util.List;

public interface UserDao {
    User getUserById(Long userId);

    List<User> getAllUsers();

    Long addUser(User user);

    void updateUser(User user);

    void deleteUser(Long userId);
}

DemoApplication.java #

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.ComponentScan;

@SpringBootApplication
//@ComponentScan("com.example.demo.service")
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

}

已尝试的操作 #

• 在DemoApplication.java添加@ComponentScan("com.example.demo.service")，无效
• 给服务类标记@Service注解
• 尝试添加@Autowired注解

问题排查与修复方案 #

1. 组件扫描范围错误
   @SpringBootApplication默认会扫描自身所在包（com.example.demo）及其所有子包的组件，但你之前添加的@ComponentScan仅指定了com.example.demo.service，导致com.example.demo.dao包下的UserDaoImpl未被扫描注册为Bean。

修复：
移除自定义的@ComponentScan配置即可，因为@SpringBootApplication已经包含了对根包的组件扫描逻辑。如果需要显式指定，可修改为扫描根包：

@SpringBootApplication
@ComponentScan("com.example.demo")
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

2. 冗余的注入注解
   UserController中同时使用@Autowired和构造函数注入属于冗余操作，Spring 4.3+会自动对仅含单个构造函数的类进行构造函数注入，可移除@Autowired：

@RestController
@RequestMapping("/api/users")
public class UserController {

    private final UserService userService;
    
    public UserController(UserService userService) {
        this.userService = userService;
    }
    // 其他方法保持不变
}

3. 数据库配置检查
   确保application.properties或application.yml中配置了正确的数据库连接信息，这样Spring才能自动创建JdbcTemplate的Bean：
   示例application.properties配置：

spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name
spring.datasource.username=your_db_username
spring.datasource.password=your_db_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

完成以上修改后重启项目，Spring即可正确扫描到UserDaoImpl并将其作为UserDao类型的Bean注入到UserServiceImpl中，问题即可解决。

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