ESP8266通过XAMPP向MySQL传数据失败：WiFi已连但数据库无法连接

云上老周

2026-5-20

嘿，我来帮你排查ESP8266连不上MySQL的问题！既然WiFi已经成功连接，那问题大概率出在数据库配置、网络权限或者代码逻辑上，咱们一步步梳理：

1. 先检查MySQL的远程访问权限

默认情况下，XAMPP自带的MySQL只允许**本地（127.0.0.1）**设备访问，而ESP8266是局域网里的另一台独立设备，必须给数据库用户开放远程权限：

打开XAMPP的MySQL控制台，执行以下命令（替换成你的数据库信息）：
```
GRANT ALL PRIVILEGES ON 你的数据库名.* TO '你的用户名'@'%' IDENTIFIED BY '你的密码';
FLUSH PRIVILEGES;
```
这里的%表示允许任何IP访问，也可以指定ESP8266的固定IP来提升安全性。
找到MySQL的配置文件（Windows是my.ini，Linux/macOS是my.cnf），修改bind-address为0.0.0.0（允许所有IP连接），然后重启MySQL服务。

2. 验证网络连通性

先排除网络层面的问题：

用电脑ping一下ESP8266的局域网IP，确认设备在局域网内可达（WiFi连成功了大概率没问题，但还是要确认）。
反过来，用电脑上的MySQL客户端（比如Navicat、Workbench），尝试用ESP所在的网络IP连接XAMPP的MySQL。如果连不上，说明是MySQL的网络配置问题，和ESP代码无关。
检查XAMPP所在电脑的防火墙，确保**3306端口（MySQL默认端口）**被允许通过，或者临时关闭防火墙测试。

3. 核对代码里的数据库参数

别小看细节，很多问题都出在这里：

代码里的server地址必须是XAMPP所在电脑的局域网IP（比如192.168.1.100），绝对不能写127.0.0.1或localhost——这两个地址对ESP来说指向它自己，不是你的服务器。
用户名、密码、数据库名要和XAMPP里的MySQL完全一致，注意MySQL在Linux环境下区分大小写，Windows不区分，但最好统一写法。
如果修改过MySQL的端口号，代码里的端口也要对应修改。

4. 更推荐的方案：用PHP中间层代替直接连接

其实ESP8266直接连接MySQL不是最优选择——MySQL协议比较重，ESP的资源有限，而且直接暴露数据库凭证有安全风险。更稳定的方式是在XAMPP上写一个简单的PHP接口，ESP通过HTTP POST把数据传给PHP，再由PHP写入数据库：

先在XAMPP的htdocs目录下创建save_sensor_data.php文件：

<?php
$servername = "localhost";
$username = "root";
$password = ""; // 你的MySQL密码
$dbname = "sensor_db"; // 你的数据库名

$conn = new mysqli($servername, $username, $password, $dbname);
if ($conn->connect_error) {
    die("数据库连接失败: " . $conn->connect_error);
}

// 获取ESP发送的传感器数据
$sensor_value = isset($_POST['value']) ? $_POST['value'] : '';
if (!empty($sensor_value)) {
    $sql = "INSERT INTO sensor_readings (data) VALUES ('$sensor_value')";
    if ($conn->query($sql) === TRUE) {
        echo "数据保存成功";
    } else {
        echo "错误: " . $sql . "<br>" . $conn->error;
    }
} else {
    echo "未接收到有效数据";
}

$conn->close();
?>

ESP端用ESP8266HTTPClient库发送POST请求：

#include <ESP8266WiFi.h>
#include <ESP8266HTTPClient.h>

const char* ssid = "你的WiFi名称";
const char* password = "WiFi密码";
const char* php_url = "http://192.168.1.100/save_sensor_data.php"; // 替换成你的服务器IP

void setup() {
  Serial.begin(115200);
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println("\nWiFi连接成功");
}

void loop() {
  if (WiFi.status() == WL_CONNECTED) {
    HTTPClient http;
    http.begin(php_url);
    http.addHeader("Content-Type", "application/x-www-form-urlencoded");

    // 模拟读取传感器数据，替换成你的真实传感器代码
    float sensor_data = 26.3;
    String post_data = "value=" + String(sensor_data);

    int http_code = http.POST(post_data);
    if (http_code > 0) {
      String response = http.getString();
      Serial.print("HTTP状态码: ");
      Serial.println(http_code);
      Serial.print("服务器响应: ");
      Serial.println(response);
    } else {
      Serial.print("请求失败，错误码: ");
      Serial.println(http_code);
    }
    http.end();
  }
  delay(5000); // 每5秒发送一次数据
}

这种方式更易排查问题——直接在浏览器访问http://你的服务器IP/save_sensor_data.php?value=test，就能测试接口是否正常。

5. 查看错误日志找线索

如果还是不行，从日志里找具体原因：

打开XAMPP控制面板，点击MySQL的「Logs」按钮，查看连接失败的记录，里面会明确提示是权限不足、密码错误还是其他问题。
查看ESP的串口输出，里面会打印数据库连接的错误码，比如1045是用户名/密码错误，10061是连接被拒绝（防火墙或远程权限未开）。

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