Android Studio开发APP无法连接局域网MySQL服务器求助

核心问题定位 #

你遇到的SQL state: 08001错误属于连接级异常，结合第三方工具能正常连接的情况，问题大概率出在Android应用的连接配置或运行环境限制上，而非数据库本身不兼容。

逐个排查解决步骤 #

1. 补充JDBC连接参数 #

MySQL 8.0+版本对连接有额外参数要求，Android环境下默认配置会触发兼容性问题，需要添加以下参数：

// 修改后的连接字符串
"jdbc:mysql://192.168.1.10:3306/sakila?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true"

• useSSL=false：关闭SSL验证（局域网环境无需加密）
• serverTimezone=UTC：指定时区，避免时区不匹配导致的连接失败
• allowPublicKeyRetrieval=true：允许客户端从服务器获取公钥，解决密钥验证问题

2. 移除外网操作到子线程 #

Android从API 11开始禁止在主线程执行网络操作，你当前直接在按钮点击的主线程中调用DriverManager.getConnection()，会被系统阻断或超时。必须将数据库连接逻辑放到子线程：

button.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        if (isNetworkAvailable()) {
            // 开启子线程执行连接操作
            new Thread(new Runnable() {
                @Override
                public void run() {
                    try (Connection connection = DriverManager.getConnection(
                            "jdbc:mysql://192.168.1.10:3306/sakila?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true", 
                            "boxapp", "12345"
                    )) {
                        Log.d("huyblya", "Connected to database");
                    } catch (SQLException e) {
                        e.printStackTrace();
                        Log.d("huyblya","Error message: " + e.getMessage());
                        Log.d("huyblya","Error code: " + e.getErrorCode());
                        Log.d("huyblya","SQL state: " + e.getSQLState());
                    }
                }
            }).start();
        } else {
            Log.d("huyblya", "No internet connection");
        }
    }
});

3. 确认MySQL用户权限 #

虽然第三方工具能连接，但需确保boxapp用户允许从手机IP访问：

-- 查看当前用户的访问权限
SELECT user, host FROM mysql.user WHERE user = 'boxapp';
-- 如果host不是%或手机IP，授权全IP访问
GRANT ALL PRIVILEGES ON sakila.* TO 'boxapp'@'%' IDENTIFIED BY '12345';
FLUSH PRIVILEGES;

4. 适配Android网络限制 #

• Android 9+明文流量限制：在AndroidManifest.xml的<application>标签中添加配置，允许明文JDBC连接：

  <application
      ...
      android:usesCleartextTraffic="true">
      ...
  </application>
  

• 局域网隔离检查：确认手机和笔记本连接同一WiFi频段（部分路由器会隔离2.4G和5G设备），关闭笔记本防火墙对3306端口的限制。

数据库选型建议 #

直接用JDBC在Android端连接MySQL并非最佳实践：

• 安全性差：账号密码硬编码在客户端，易被反编译泄露
• 稳定性差：移动端网络波动大，直接连数据库易出现连接中断
• 扩展性差：无法处理多客户端并发，也无法添加业务逻辑层

更合适的方案：

1. 搭建中间API服务：用Spring Boot、Node.js等写轻量API，Android通过HTTP/HTTPS调用API，由API与数据库交互
2. 云端托管数据库：使用Firebase Realtime Database、Firestore等，自带移动端SDK，无需自建服务器
3. 本地数据库：如果仅需离线存储，使用SQLite即可

内容的提问来源于stack exchange，提问作者Kostya Onyschuk