在使用JDBC操作MySQL数据库时,LOAD DATA命令是批量导入数据的高效方式,但不少开发者会遇到执行该命令失败的情况,常见报错包括访问被拒绝、文件找不到等问题。

问题常见原因
JDBC连接MySQL无法使用LOAD DATA命令,主要有三类原因:
- MySQL用户没有FILE权限,无法读取服务器端的文件
- JDBC连接字符串没有开启本地文件加载的支持
- 文件路径配置错误,混淆了客户端本地文件和数据库服务器文件的路径
解决方法
1. 授予MySQL用户FILE权限
LOAD DATA命令需要执行用户拥有FILE权限,才能读取服务器端的文件。可以登录MySQL执行以下命令授予权限:
-- 授予用户FILE权限,假设用户是test_user,host是% GRANT FILE ON *.* TO 'test_user'@'%'; -- 刷新权限使配置生效 FLUSH PRIVILEGES;
2. 调整JDBC连接字符串参数
如果是从客户端本地加载文件,需要在JDBC连接字符串中添加allowLoadLocalInfile=true参数,默认该参数是关闭的,会导致本地文件加载失败。
完整的连接字符串示例:
String url = "jdbc:mysql://127.0.0.1:3306/test_db?useSSL=false&allowLoadLocalInfile=true&serverTimezone=UTC"; String username = "test_user"; String password = "test_pwd"; Connection conn = DriverManager.getConnection(url, username, password);
3. 区分文件路径的使用场景
LOAD DATA有两种常见的使用场景,路径配置需要注意差异:
| 场景 | 命令格式 | 路径说明 |
|---|---|---|
| 加载数据库服务器本地文件 | LOAD DATA INFILE '/server/path/data.txt' INTO TABLE test_table | 路径是MySQL服务器所在的文件系统的绝对路径,需要FILE权限 |
| 加载客户端本地文件 | LOAD DATA LOCAL INFILE '/client/path/data.txt' INTO TABLE test_table | 路径是运行JDBC程序的客户端机器的路径,需要连接字符串开启allowLoadLocalInfile |
完整代码示例
以下是一个使用JDBC执行LOAD DATA LOCAL INFILE命令的完整示例,实现从客户端本地文件导入数据到MySQL表:
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.Statement;
public class JdbcLoadDataDemo {
public static void main(String[] args) {
String url = "jdbc:mysql://127.0.0.1:3306/test_db?useSSL=false&allowLoadLocalInfile=true&serverTimezone=UTC";
String username = "test_user";
String password = "test_pwd";
Connection conn = null;
Statement stmt = null;
try {
// 加载驱动
Class.forName("com.mysql.cj.jdbc.Driver");
// 获取连接
conn = DriverManager.getConnection(url, username, password);
stmt = conn.createStatement();
// 执行LOAD DATA命令,导入客户端本地文件
String sql = "LOAD DATA LOCAL INFILE '/Users/test/data.txt' INTO TABLE user_table " +
"FIELDS TERMINATED BY ',' LINES TERMINATED BY 'n' " +
"(id, name, age)";
int rows = stmt.executeUpdate(sql);
System.out.println("成功导入" + rows + "条数据");
} catch (Exception e) {
e.printStackTrace();
} finally {
// 关闭资源
try {
if (stmt != null) stmt.close();
if (conn != null) conn.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
}
注意事项
- 如果使用的是MySQL 8.0以上版本,默认会禁用LOCAL INFILE功能,除了在连接字符串添加参数,还需要在MySQL服务端配置文件中设置
local_infile=ON,然后重启MySQL服务 - 文件路径中的分隔符需要注意,Windows系统使用反斜杠时需要转义,比如
C:\data\test.txt,Linux和Mac系统使用正斜杠即可 - 执行命令前需要确认目标表已经存在,且文件字段数量和表的字段数量匹配,否则会导入失败