以下是使用 Spring Boot 和 Spring Data JPA 从 users 表读取数据的完整示例：

1. 创建 Spring Boot 项目
   使用 Spring Initializr 创建一个新项目，添加以下依赖：
   • Spring Web

• Spring Data JPA

• MySQL Driver（或其他数据库驱动，如H2、PostgreSQL等）

2. 配置数据库连接
   在 src/main/resources/application.properties 中添加数据库配置：

   # 数据库连接配置
   spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name
   spring.datasource.username=root
   spring.datasource.password=your_password
   spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
   

JPA 配置

spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

---

3. 创建 User 实体类
在 `src/main/java` 下创建 `User.java` 实体类，对应 `users` 表：
```java
import javax.persistence.*;

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "username")
    private String username;

    @Column(name = "email")
    private String email;

    // 必须有无参构造函数
    public User() {}

    // Getters 和 Setters
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
}

4. 创建 Repository 接口
   创建 UserRepository.java 接口，继承 JpaRepository：

   import org.springframework.data.jpa.repository.JpaRepository;
   

public interface UserRepository extends JpaRepository<User, Long> {
// 可自定义查询方法（根据业务需求）
User findByUsername(String username);
User findByEmail(String email);
}

---

5. 创建 Service 层
创建 `UserService.java` 处理业务逻辑：
```java
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

    public List<User> getAllUsers() {
        return userRepository.findAll();
    }

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }

    // 其他业务方法...
}

6. 创建 Controller 层
   创建 UserController.java 处理 HTTP 请求：

   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 UserService userService;

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

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

}

---

7. 运行并测试
启动 Spring Boot 应用后，通过以下方式测试：
• 访问所有用户：`GET http://localhost:8080/api/users/getAllUsers`

• 根据ID查询用户：`GET http://localhost:8080/api/users/1`


---

8. 高级查询示例
在 `UserRepository` 中添加自定义查询：
```java
// 使用 JPQL 查询
@Query("SELECT u FROM User u WHERE u.email LIKE %?1%")
List<User> findByEmailContaining(String email);

// 使用原生 SQL 查询
@Query(value = "SELECT * FROM users WHERE username = ?1", nativeQuery = true)
User findByUsernameNative(String username);

可能遇到的问题及解决

1. 数据库连接失败
   检查 application.properties 中的数据库配置是否正确。

2. 实体类与表结构不匹配
   确保 @Column(name = "xxx") 与数据库列名一致。

3. JPA 未扫描到 Repository
   确保主启动类位于根包，或通过 @EnableJpaRepositories 手动指定包路径。

4. 字段未映射
   如果实体类字段名与数据库列名不同，必须使用 @Column 注解显式映射。

通过以上步骤，您可以在 Spring Boot 中完成对 users 表的基本读取操作。

项目结构（关键路径）

src/main/java/
└── com.example.demo
    ├── DemoApplication.java          # 主启动类（根包）
    ├── entity                       
    │   └── User.java                # 实体类
    ├── repository                   
    │   └── UserRepository.java      # JPA Repository 接口
    ├── service                      
    │   └── UserService.java         # Service 层
    └── controller                   
        └── UserController.java      # Controller 层

1. 实体类路径：entity/User.java

   package com.example.demo.entity;  // 包路径：entity包
   

import javax.persistence.*;

@Entity
@Table(name = “users”)
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

@Column(name = "username")
private String username;

@Column(name = "email")
private String email;

// 无参构造方法、Getter 和 Setter

}

---

2. Repository 接口路径：`repository/UserRepository.java`
```java
package com.example.demo.repository;  // 包路径：repository包

import com.example.demo.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
    // 自定义方法示例
    User findByUsername(String username);
}

3. Service 类路径：service/UserService.java

   package com.example.demo.service;  // 包路径：service包
   

import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;

@Service
public class UserService {
@Autowired
private UserRepository userRepository;

public List<User> getAllUsers() {
    return userRepository.findAll();
}

}

---

4. Controller 类路径：`controller/UserController.java`
```java
package com.example.demo.controller;  // 包路径：controller包

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;

@RestController
@RequestMapping("/api/users")
public class UserController {
    @Autowired
    private UserService userService;

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

5. 主启动类路径：根包 DemoApplication.java

   package com.example.demo;  // 根包路径
   

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

---

关键注意事项
1. 包层级关系  
   • 主启动类 `DemoApplication.java` 必须放在 根包（如 `com.example.demo`）下，否则 Spring Boot 无法自动扫描子包中的组件（如 `@Entity`、`@Service`、`@Controller` 等）。


2. 组件扫描  
   • 如果自定义包名（例如 `com.example.app`），需确保所有类都在根包或其子包下，否则需要手动指定扫描路径：

     ```java
     @SpringBootApplication
     @EntityScan("com.example.app.entity")          // 指定实体类包
     @EnableJpaRepositories("com.example.app.repository")  // 指定 Repository 包
     @ComponentScan("com.example.app")              // 指定组件扫描包
     ```

3. 配置文件路径  
   • `application.properties` 必须放在 `src/main/resources` 目录下。


---

最终测试
启动项目后，访问接口：  
```bash
GET http://localhost:8080/api/users

如果返回用户数据，说明路径和代码均配置正确！

如果有其他问题，欢迎随时追问！