IDEA中为SpringBoot项目接入MySQL数据库的详细指南

 更新时间:2025年05月26日 10:13:49   作者:一切皆有迹可循  
MySQL作为最流行的开源关系型数据库,与Spring Boot的整合是企业级开发的标配,本文将手把手教你‌在IntelliJ IDEA中为Spring Boot项目接入MySQL数据库‌,有需要的可以了解下

‌前言

MySQL作为最流行的开源关系型数据库,与Spring Boot的整合是企业级开发的标配。本文将手把手教你‌在IntelliJ IDEA中为Spring Boot项目接入MySQL数据库‌,涵盖‌依赖配置‌、‌实体类映射‌、‌JPA操作‌及‌常见避坑指南‌,助你快速实现数据持久化!

‌一、环境准备

1. ‌基础环境

已安装IntelliJ IDEA并创建Spring Boot项目(参考文章)。

本地安装MySQL 5.7+(推荐8.0),并创建数据库(如springboot_db)。

2. ‌检查依赖

确保项目包含Spring Web、Spring Data JPA和MySQL Driver依赖(可通过pom.xml添加)。

‌二、添加MySQL依赖

修改pom.xml

在<dependencies>中添加以下依赖:

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

<!-- MySQL驱动(版本需与本地MySQL一致) -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

<!-- 可选:Lombok简化代码 -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

‌注意‌:Spring Boot 3.x默认使用MySQL 8.x驱动,若使用MySQL 5.x需指定驱动版本(如5.1.49)。

‌三、配置MySQL连接

‌1. 修改application.properties

在src/main/resources/application.properties中添加数据库配置:

# 数据源配置
spring.datasource.url=jdbc:mysql://localhost:3306/springboot_db?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

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

‌关键参数解释‌:

  • spring.jpa.hibernate.ddl-auto=update:启动时自动更新表结构(可选create、none)。
  • useSSL=false:禁用SSL(本地开发可关闭)。
  • serverTimezone=UTC:统一时区,避免时间差问题。

‌2. 验证配置

启动项目,若控制台输出以下日志,说明数据库连接成功:

HikariPool-1 - Start completed

‌四、创建实体类与Repository

‌1. 定义实体类(User)

package com.example.demo.entity;

import jakarta.persistence.*;
import lombok.Data;

@Data
@Entity
@Table(name = "user") // 指定表名
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(nullable = false, unique = true)
    private String username;
    
    @Column(nullable = false)
    private String password;
    
    private String email;
}

‌注解说明‌:

  • @Entity:标记为JPA实体。
  • @Table:指定映射的表名。
  • @Data:Lombok注解,自动生成getter/setter。

‌2. 创建Repository接口

package com.example.demo.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);
}

五、编写Service与Controller

‌1. 实现Service层

package com.example.demo.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;

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

    public User saveUser(User user) {
        return userRepository.save(user);
    }

    public User findUserByUsername(String username) {
        return userRepository.findByUsername(username);
    }
}

‌2. 编写RESTful Controller

package com.example.demo.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.*;

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

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.saveUser(user);
    }

    @GetMapping("/{username}")
    public User getUser(@PathVariable String username) {
        return userService.findUserByUsername(username);
    }
}

‌六、测试与验证

‌1. 启动应用

运行启动类DemoApplication,观察控制台是否生成建表SQL:

create table user (
    id bigint not null auto_increment,
    email varchar(255),
    password varchar(255) not null,
    username varchar(255) not null unique,
    primary key (id)
);

‌2. 使用Postman测试API

‌新增用户‌(POST请求):URL:http://localhost:8080/api/users

Body(JSON):

{
  "username": "csdn_user",
  "password": "123456",
  "email": "csdn@example.com"
}

‌查询用户‌(GET请求):URL:http://localhost:8080/api/users/csdn_user

‌七、常见问题与解决方案

‌Q1:数据库连接失败(Access denied)

原因‌:用户名/密码错误,或用户无权限访问数据库。

‌解决‌:

检查application.properties中的username和password。

在MySQL中授权用户:

GRANT ALL PRIVILEGES ON springboot_db.* TO 'root'@'localhost';
FLUSH PRIVILEGES;

‌Q2:驱动类未找到(Driver class not found)

原因‌:MySQL驱动版本与配置不匹配。

‌解决‌:

检查spring.datasource.driver-class-name是否为com.mysql.cj.jdbc.Driver(MySQL 8.x)。

确认pom.xml中MySQL依赖未冲突。

Q3:时区错误(ServerTimezone not configured)

‌解决‌:在JDBC URL中添加&serverTimezone=Asia/Shanghai(或UTC)。

‌Q4:表不存在(Table ‘springboot_db.user’ doesn’t exist)

解决‌:

确保spring.jpa.hibernate.ddl-auto=update。

检查实体类@Table(name="user")是否与数据库表名一致。

总结

通过Spring Data JPA,开发者无需编写SQL即可实现MySQL数据库的CRUD操作。本文从配置到实战演示了完整的接入流程,并针对常见错误提供解决方案。

到此这篇关于IDEA中为SpringBoot项目接入MySQL数据库的详细指南的文章就介绍到这了,更多相关IDEA SpringBoot接入MySQL数据库内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java打乱数组元素简单代码例子

    Java打乱数组元素简单代码例子

    在Java编程中,我们经常需要对数组进行乱序操作(即将数组中的元素随机打乱顺序),这篇文章主要给大家介绍了关于Java打乱数组元素的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-03-03
  • SpringAI+Ollama本地模型实现快速对话的实战指南

    SpringAI+Ollama本地模型实现快速对话的实战指南

    SpringAI是Spring官方推出的AI应用开发框架,旨在统一封装多种大模型,提供一套代码无缝切换不同模型的功能,下面我们就来看看SpringAI如何结合Ollama实现快速对话功能吧
    2026-05-05
  • 在mybatis中使用mapper进行if条件判断

    在mybatis中使用mapper进行if条件判断

    这篇文章主要介绍了在mybatis中使用mapper进行if条件判断,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-01-01
  • Java实现克鲁斯卡尔算法的示例代码

    Java实现克鲁斯卡尔算法的示例代码

    克鲁斯卡尔算法是一种用于求解最小生成树问题的贪心算法。这篇文章主要为大家详细介绍了Java实现克鲁斯卡尔算法的方法,需要的可以参考一下
    2023-04-04
  • Spring Boot Dubbo 构建分布式服务的方法

    Spring Boot Dubbo 构建分布式服务的方法

    这篇文章主要介绍了Spring Boot Dubbo 构建分布式服务的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-05-05
  • springmvc+spring+mybatis实现用户登录功能(上)

    springmvc+spring+mybatis实现用户登录功能(上)

    这篇文章主要为大家详细介绍了springmvc+spring+mybatis实现用户登录功能,比较基础的学习教程,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-07-07
  • IDEA的下载和使用安装详细图文教程

    IDEA的下载和使用安装详细图文教程

    这篇文章主要介绍了IDEA的下载和使用安装,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-08-08
  • 关于mybatis3中@SelectProvider的使用问题

    关于mybatis3中@SelectProvider的使用问题

    这篇文章主要介绍了mybatis3中@SelectProvider的使用技巧,@SelectProvide指定一个Class及其方法,并且通过调用Class上的这个方法来获得sql语句,本文通过实例代码给大家介绍的非常详细,需要的朋友可以参考下
    2021-12-12
  • SpringBoot实现动态多线程并发定时任务

    SpringBoot实现动态多线程并发定时任务

    这篇文章主要为大家详细介绍了SpringBoot实现动态多线程并发定时任务,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-05-05
  • SpringMVC整合SSM实现表现层数据封装详解

    SpringMVC整合SSM实现表现层数据封装详解

    这篇文章主要介绍了SpringMVC整合SSM实现表现层数据封装,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习吧
    2022-10-10

最新评论