使用Ajax+PHP将JSON数据插入MySQL失败，该从何处排查？

数据老陈

2026-5-26

这种前后端联动的问题确实容易让人摸不着头脑，咱们一步步拆解排查，从最直观的前端开始，再到后端和数据库：

第一步：先排查前端Ajax是否正确发送了数据

打开浏览器开发者工具（F12），切换到Network标签，点击#btnprueba按钮，找到对应的请求（大概率是POST请求）
查看请求的Headers：确认请求URL是否正确，请求方法是否和PHP端预期一致（比如POST），请求头里的Content-Type是否匹配你发送的数据格式（如果是JSON，应该是application/json；如果是表单，就是application/x-www-form-urlencoded）
查看请求的Payload（或Form Data）：检查JSON数据结构是否完整，有没有缺失字段、格式错误（比如引号未闭合、多余逗号）
在JS代码里加个console.log(array1)，点击按钮后看控制台输出的数组结构，尤其要确认你没写完的firstTableData.Descripcion = $(this...部分是否正确获取到了表格里的内容，避免字段值为空或未定义

第二步：排查后端PHP是否正确接收并处理数据

先在PHP开头加调试代码，直接输出收到的数据，帮你确认前端数据是否传到位：
```
// 如果是JSON格式请求，用这个接收
$input = file_get_contents('php://input');
$data = json_decode($input, true);
var_dump($data);

// 如果是普通表单提交，用这个
// var_dump($_POST);
```
然后在Network标签的Response里查看输出结果，如果是空的，说明前端数据格式或PHP接收方式不匹配
开启PHP错误提示，方便捕捉语法或运行时错误：
```
error_reporting(E_ALL);
ini_set('display_errors', 1);
```

检查JSON解析是否成功：如果用json_decode，可以加判断输出错误信息：

if(json_last_error() !== JSON_ERROR_NONE){
    echo "JSON解析错误: " . json_last_error_msg();
}

第三步：排查MySQL查询是否正确执行

把要执行的SQL语句打印出来，拿到数据库管理工具（比如phpMyAdmin）里直接执行，验证语句本身是否正确：
```
$sql = "INSERT INTO tu_tabla (ID_Articulo, Descripcion) VALUES ('{$data['ID_Articulo']}', '{$data['Descripcion']}')";
echo $sql; // 复制这个输出的SQL去数据库测试
```
如果直接执行SQL也失败，那大概率是字段名写错、数据类型不匹配、主键重复这类问题

确认数据库连接是否正常：在PHP连接数据库的代码后加错误提示：

$conn = mysqli_connect('主机地址', '用户名', '密码', '数据库名');
if (!$conn) {
    die("数据库连接失败: " . mysqli_connect_error());
}

建议用预处理语句执行SQL，既避免SQL注入，又能直接拿到执行错误信息：

$stmt = mysqli_prepare($conn, "INSERT INTO tu_tabla (ID_Articulo, Descripcion) VALUES (?, ?)");
mysqli_stmt_bind_param($stmt, "ss", $data['ID_Articulo'], $data['Descripcion']);
mysqli_stmt_execute($stmt);

// 查看执行结果
if(mysqli_stmt_affected_rows($stmt) > 0){
    echo "数据插入成功";
} else {
    echo "插入失败: " . mysqli_stmt_error($stmt);
}

第四步：给Ajax加上错误回调，捕捉请求异常

在你的Ajax代码里补充错误处理，这样请求出错时能直接在控制台看到原因：

$.ajax({
    url: '你的PHP文件路径',
    type: 'POST',
    data: JSON.stringify(array1),
    contentType: 'application/json', // 注意和后端接收方式匹配
    success: function(response){
        console.log('后端响应:', response);
    },
    error: function(xhr, status, error){
        console.log('请求错误:', error);
        console.log('响应状态:', status);
        console.log('后端报错:', xhr.responseText);
    }
});

按照这个顺序排查，基本上能定位到是Ajax、PHP还是数据库的问题啦！

内容的提问来源于stack exchange，提问作者Gammath.rar