最完整Spring Boot集成PostgreSQL指南：从配置到高级查询实战-优快云博客

最完整Spring Boot集成PostgreSQL指南：从配置到高级查询实战

【免费下载链接】springboot-learning-example spring boot 实践学习案例，是 spring boot 初学者及核心技术巩固的最佳实践。项目地址: https://gitcode.com/gh_mirrors/sp/springboot-learning-example

你还在为Spring Boot项目选择合适的关系型数据库吗？PostgreSQL（Postgres）作为功能完备的开源数据库，提供了强大的事务支持、复杂查询能力和扩展性。本文将带你从零开始，在springboot-learning-example项目中集成PostgreSQL，掌握从基础配置到高级查询的全流程。读完你将获得：

3分钟快速搭建PostgreSQL开发环境
标准化的Spring Boot数据访问层实现
分页/排序/复杂查询的最佳实践
性能优化与事务管理技巧

环境准备与依赖配置

1. 基础环境要求

确保开发环境已安装：

JDK 8+（推荐11）
Maven 3.6+
PostgreSQL 12+（官方下载）

2. 添加PostgreSQL依赖

在项目模块的pom.xml中添加PostgreSQL驱动和Spring Data JPA依赖。以chapter-5-spring-boot-data-jpa/pom.xml为例，需包含：

<!-- PostgreSQL驱动 -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <scope>runtime</scope>
</dependency>

<!-- Spring Data JPA -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

数据库配置与连接

1. 配置数据库连接信息

在application.properties或application.yml中添加PostgreSQL连接配置。创建src/main/resources/application-postgres.properties：

# PostgreSQL连接配置
spring.datasource.url=jdbc:postgresql://localhost:5432/springboot_db
spring.datasource.username=postgres
spring.datasource.password=yourpassword
spring.datasource.driver-class-name=org.postgresql.Driver

# JPA配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
spring.jpa.properties.hibernate.format_sql=true

2. 多环境配置激活

在主配置文件中激活PostgreSQL环境：

# application.properties
spring.profiles.active=postgres

数据模型与Repository实现

1. 创建实体类

以图书管理为例，创建src/main/java/demo/springboot/domain/Book.java：

package demo.springboot.domain;

import javax.persistence.*;
import java.time.LocalDate;

@Entity
@Table(name = "books")
public class Book {
    
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(nullable = false, length = 200)
    private String title;
    
    @Column(name = "author_name", length = 100)
    private String author;
    
    @Column(precision = 10, scale = 2)
    private BigDecimal price;
    
    @Column(name = "publication_date")
    private LocalDate publicationDate;
    
    // 省略getter/setter/构造函数
}

2. 实现Repository接口

创建src/main/java/demo/springboot/domain/BookRepository.java：

package demo.springboot.domain;

import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;

import java.util.List;

public interface BookRepository extends JpaRepository<Book, Long> {
    
    // 按作者查询
    List<Book> findByAuthor(String author);
    
    // 分页查询
    Page<Book> findByTitleContaining(String keyword, Pageable pageable);
    
    // 原生SQL查询
    @Query(value = "SELECT * FROM books WHERE price > :minPrice AND publication_date > :date", 
           nativeQuery = true)
    List<Book> findExpensiveBooksAfterDate(@Param("minPrice") BigDecimal minPrice, 
                                          @Param("date") LocalDate date);
}

服务层与控制器实现

1. 业务服务实现

创建src/main/java/demo/springboot/service/BookService.java：

package demo.springboot.service;

import demo.springboot.domain.Book;
import demo.springboot.domain.BookRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Pageable;
import org.springframework.data.domain.Sort;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

import java.math.BigDecimal;
import java.time.LocalDate;
import java.util.List;

@Service
public class BookService {

    private final BookRepository bookRepository;

    @Autowired
    public BookService(BookRepository bookRepository) {
        this.bookRepository = bookRepository;
    }
    
    @Transactional(readOnly = true)
    public Page<Book> findBooks(String keyword, int page, int size) {
        Pageable pageable = PageRequest.of(page, size, Sort.by("publicationDate").descending());
        return bookRepository.findByTitleContaining(keyword, pageable);
    }
    
    @Transactional
    public Book saveBook(Book book) {
        return bookRepository.save(book);
    }
    
    @Transactional(readOnly = true)
    public List<Book> findRecentExpensiveBooks() {
        return bookRepository.findExpensiveBooksAfterDate(
            new BigDecimal("50.00"), 
            LocalDate.now().minusYears(1)
        );
    }
}

2. REST控制器实现

创建src/main/java/demo/springboot/web/BookController.java：

package demo.springboot.web;

import demo.springboot.domain.Book;
import demo.springboot.service.BookService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.domain.Page;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/books")
public class BookController {

    private final BookService bookService;

    @Autowired
    public BookController(BookService bookService) {
        this.bookService = bookService;
    }
    
    @GetMapping
    public ResponseEntity<Page<Book>> getBooks(
            @RequestParam(defaultValue = "") String keyword,
            @RequestParam(defaultValue = "0") int page,
            @RequestParam(defaultValue = "10") int size) {
        
        Page<Book> books = bookService.findBooks(keyword, page, size);
        return ResponseEntity.ok(books);
    }
    
    @PostMapping
    public ResponseEntity<Book> createBook(@RequestBody Book book) {
        Book savedBook = bookService.saveBook(book);
        return ResponseEntity.ok(savedBook);
    }
    
    @GetMapping("/expensive")
    public ResponseEntity<List<Book>> getExpensiveBooks() {
        return ResponseEntity.ok(bookService.findRecentExpensiveBooks());
    }
}

测试与验证

1. 启动应用程序

运行src/main/java/demo/springboot/WebApplication.java：

package demo.springboot;

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

@SpringBootApplication
public class WebApplication {

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

2. 验证数据库连接

应用启动后，检查控制台输出，确认PostgreSQL连接成功：

HikariPool-1 - Starting...
HikariPool-1 - Start completed.
HHH000412: Hibernate ORM core version 5.4.32.Final
HHH000204: Processing PersistenceUnitInfo [name: default]
HHH000417: Using dialect: org.hibernate.dialect.PostgreSQLDialect

3. API测试示例

使用curl或Postman测试API：

# 创建图书
curl -X POST http://localhost:8080/api/books \
  -H "Content-Type: application/json" \
  -d '{"title":"Spring Boot实战","author":"张三","price":69.99,"publicationDate":"2023-01-15"}'

# 分页查询
curl "http://localhost:8080/api/books?keyword=Spring&page=0&size=5"

高级功能与最佳实践

1. PostgreSQL特有功能应用

JSON数据类型处理

PostgreSQL支持JSON字段类型，修改实体类：

@Column(columnDefinition = "jsonb")
private String metadata; // 存储JSON数据

全文搜索

利用PostgreSQL全文搜索能力：

@Query(value = "SELECT * FROM books WHERE to_tsvector('english', title || ' ' || author) @@ plainto_tsquery('english', :query)",
       nativeQuery = true)
List<Book> fullTextSearch(@Param("query") String query);

2. 性能优化策略

添加适当索引：

CREATE INDEX idx_books_title ON books USING gin(to_tsvector('english', title));
CREATE INDEX idx_books_publication_date ON books(publication_date);

配置连接池：

spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.idle-timeout=300000

3. 事务管理

使用@Transactional注解确保数据一致性：

@Transactional
public void batchUpdateBooks(List<Book> books) {
    for (Book book : books) {
        bookRepository.save(book);
        // 可添加业务逻辑和异常处理
    }
}

总结与扩展

本文详细介绍了在springboot-learning-example项目中集成PostgreSQL的全过程，包括环境配置、数据模型设计、Repository实现、服务层与控制器开发，以及高级功能和性能优化技巧。通过chapter-5-spring-boot-data-jpa模块的实践，你可以快速掌握Spring Boot与PostgreSQL的集成要点。

后续可探索：

读写分离实现
数据库迁移工具Flyway/Liquibase集成
分布式事务处理
PostgreSQL高级特性（如数组类型、地理信息）

完整代码示例可参考项目中的springboot-data-jpa模块，更多Spring Boot学习案例请查阅README.md。

提示：实际项目开发中，建议使用环境变量存储数据库密码等敏感信息，避免硬编码。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考