Flutter要访问MySQL数据库，最稳妥的方案是借助后端API作为桥梁，直接连接虽可行但风险较高，不适合生产环境。
Flutter如何访问MySQL数据库？两种主流方案对比
对于刚接触Flutter的开发者,常会问“Flutter能直接连MySQL吗”，答案是：技术上可以，但实际项目中几乎没人这么干，市面上主要存在两条路：后端API桥接和Flutter插件直连，下面拆开聊。
后端API桥接（推荐方案）
绝大多数Flutter应用会选择在App和后端数据库之间加一层API服务,Flutter通过HTTP请求（通常是JSON格式）与后端通信，后端负责解析请求、操作MySQL并返回结果，这种模式下，Flutter根本不感知数据库的存在，它只关心API返回的数据。
- 安全性高：数据库凭证、连接串全部留在后端，App端无需暴露任何敏感信息。
- 扩展性强：后端可以轻松接入缓存、负载均衡、微服务等架构，Flutter端只需按接口格式调整。
- 维护友好：修改数据库结构或切换数据库类型（比如从MySQL迁到PostgreSQL）时，后端改动即可，App端几乎不用改代码。
Flutter插件直接连接（备选方案）
Flutter生态提供了几个插件,比如mysql1和mysql_client，能让App直连MySQL服务器，使用方式类似后端语言，构建连接、执行SQL、处理结果。
import 'package:mysql1/mysql1.dart';
Future<void> queryDB() async {
final conn = await MySqlConnection.connect(ConnectionSettings(
host: 'your-server-ip',
port: 3306,
user: 'username',
db: 'database_name',
password: 'password',
));
var results = await conn.query('SELECT FROM users');
print(results.toList());
await conn.close();
}
代码看起来简洁,但踩坑的地方不少。
- 安全隐患：数据库IP、端口、账号密码全写在App里，反编译后无处遁形。
- 网络限制：MySQL默认端口3306容易被防火墙屏蔽，且直连对公网要求高，延迟和稳定性难控制。
- 连接管理：Flutter是移动端，网络状态频繁变化，直接维持长连接会带来断线重连、连接池耗尽等问题。
Flutter连接MySQL数据库的插件详解
如果你只是为了学习或内部工具,想试试直连，下面几个插件可以留意，但请记住：生产环境，务必走后端API。
mysql1
老牌插件,基于Dart原生实现，支持查询、参数绑定、事务，但更新频率较低，遇到Flutter新版本可能需手动适配，社区反馈中，部分开发者抱怨连接不稳定，尤其在弱网环境。
mysql_client
相对年轻,API更贴近现代Dart风格，支持异步流式查询，文档和示例较少，但GitHub上活跃度尚可，适合有一定能力的开发者自定义封装。
前提条件
- MySQL服务器必须开启远程访问权限（修改
bind-address，新建允许远程登录的用户）。 - 移动端或桌面端网络能直连服务器IP和端口（云服务器需在安全组里放行3306）。
- 考虑SSL加密连接,否则数据传输是明文，极易被截获。
实战：Flutter通过REST API访问MySQL数据库
下面演示从头搭建一条Flutter向后端发请求、后端操作MySQL、再返回数据的完整链路，这是目前最通用的做法，适合大多数场景。
第一步：搭建后端API服务
这里用Node.js + Express + mysql2为例，轻量、快速上手。
const express = require('express');
const mysql = require('mysql2/promise');
const app = express();
app.use(express.json());
const pool = mysql.createPool({
host: 'localhost',
user: 'root',
password: 'yourpassword',
database: 'flutter_demo',
waitForConnections: true,
connectionLimit: 10,
});
// 获取用户列表
app.get('/api/users', async (req, res) => {
const [rows] = await pool.query('SELECT FROM users');
res.json(rows);
});
// 新增用户
app.post('/api/users', async (req, res) => {
const { name, email } = req.body;
const [result] = await pool.query('INSERT INTO users (name, email) VALUES (?, ?)', [name, email]);
res.json({ id: result.insertId });
});
app.listen(3000, () => console.log('API running on port 3000'));
启动该服务后,Flutter就可以通过http://your-server-ip:3000/api/users获取数据。
第二步：Flutter端发起HTTP请求
在Flutter项目中添加http包，然后封装数据请求。
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<List<User>> fetchUsers() async {
final response = await http.get(Uri.parse('http://your-server-ip:3000/api/users'));
if (response.statusCode == 200) {
List jsonList = jsonDecode(response.body);
return jsonList.map((e) => User.fromJson(e)).toList();
} else {
throw Exception('Failed to load users');
}
}
第三步：数据解析与展示
定义Model,再用ListView把数据渲染出来，整个过程Flutter只管View层，数据逻辑全交给后端。
这种模式的好处是：Flutter访问MySQL数据库的细节被完全隔离在服务端，App端只需学会处理JSON即可。
Flutter直接连接MySQL的注意事项
如果你确实需要在某些特殊场景下直连（比如本地局域网工具、原型验证），有几条红线必须守住。
安全第一
- 绝对不要把数据库凭证硬编码,可以使用环境变量，或在运行时通过加密文件读取。
- 使用
mysql1时务必开启SSL连接，避免明文传输。
连接复用
直连场景下,每次请求都新建连接会严重拖慢性能，建议使用连接池（但Dart端没有成熟方案，后端才有），直连时，可以考虑在应用启动时创建一次连接，整个生命周期复用，但面临断线重连难题。
性能测试先行
在移动网络下,直接连接MySQL的延迟往往比API方式高不少，据统计，从Flutter发出请求到收到数据，API方案平均耗时在200-500ms，而直连方案经常超过1秒，且丢包率更高，建议在真实网络环境下压测后再决定是否采用。
Flutter访问MySQL常见问题解答
Flutter可以直接连接MySQL数据库吗？
可以，通过`mysql1`或`mysql_client`插件能实现直连，但仅限于学习或内部工具，涉及用户数据、上线项目，必须使用后端API，行业共识认为，直连方案在安全性、稳定性和可维护性上都存在明显短板。
Flutter连接MySQL有哪些库？
主要有`mysql1`（老牌）和`mysql_client`（较新），sqflite`是Flutter内置的SQLite方案，和MySQL无关，如果你看到有文章拿`sqflite`当MySQL，那是概念混淆，选择时，优先考虑`mysql1`，因为它文档相对全，社区踩坑记录多。
Flutter mysql 怎么连接后端数据库？
最普遍的做法是：后端用Node.js、Java、Python等语言编写REST API，Flutter通过`http`或`dio`包发送请求，后端负责管理数据库连接、执行SQL、返回JSON，Flutter层面只关心接口调用和UI呈现，这是目前多数生产级Flutter应用的标配架构。
Flutter和MySQL的组合非常常见,但连接方式往往决定了项目的成败。走后端API，安全、稳定、易扩展；走直连，灵活但风险高，建议根据实际场景选择：外部线上项目，后端API是唯一可靠路径；本地调试，直连可以快速验证，无论哪种，数据安全始终是底线。
首发原创文章，作者：王坚，如若转载，请注明出处：https://test.idctop.com/article/559137.html
