微信小程序wx.request数据接收教程

从现在开始，我们要努力学习啦！今天我给大家带来《小程序wx.request接收数据方法详解》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

小程序POST请求PHP收不到$_POST数据是因为默认content-type为application/json，PHP仅自动解析x-www-form-urlencoded和multipart/form-data；需用file_get_contents('php://input')读取并json_decode解析。

小程序调用 wx.request 发起的 POST 请求，PHP 后端默认收不到 $_POST 数据——这不是 PHP 的问题，而是微信小程序默认以 application/json 格式发送请求体，而 PHP 只自动解析 application/x-www-form-urlencoded 和 multipart/form-data 两类请求体。

PHP 无法获取 $_POST 是因为请求体是 JSON

小程序代码中若这样写：

wx.request({
  url: 'https://yourdomain.com/api/login.php',
  method: 'POST',
  data: { username: 'admin', password: '123' },
  header: { 'content-type': 'application/json' }
});

此时 PHP 的 $_POST 为空数组，因为：

• application/json 请求体不会被 PHP 自动解析进 $_POST
• 原始数据全部在 php://input 流中，需手动读取并解码
• 若小程序没显式设置 header，wx.request 默认使用 application/json（注意：基础库 2.10.4+ 默认行为）

PHP 正确接收小程序 JSON 请求的写法

在 api/login.php 中按以下步骤处理：

• 先用 file_get_contents('php://input') 读取原始请求体
• 用 json_decode() 解析为 PHP 数组或对象（推荐 true 参数转数组）
• 检查是否解析成功，避免空值或格式错误导致后续逻辑崩溃

$raw = file_get_contents('php://input');
$data = json_decode($raw, true);

if (json_last_error() !== JSON_ERROR_NONE) {
    http_response_code(400);
    echo json_encode(['error' => 'Invalid JSON']);
    exit;
}

$username = $data['username'] ?? '';
$password = $data['password'] ?? '';

想用 $_POST？小程序必须改 content-type

如果坚持用 $_POST，小程序端需显式改成表单编码，并确保 data 是普通对象（非 JSON 字符串）：

wx.request({
  url: 'https://yourdomain.com/api/login.php',
  method: 'POST',
  data: { username: 'admin', password: '123' },
  header: { 'content-type': 'application/x-www-form-urlencoded' }
});

此时 PHP 才能直接用 $_POST['username']。但要注意：

• 小程序会自动将 data 对象 URL 编码，不支持嵌套对象或数组（如 { user: { name: 'a' } } 会被扁平化或丢失）
• 文件上传、复杂结构数据必须走 application/json + php://input
• 部分云开发或代理网关可能重写 header，导致实际 content-type 与预期不符

调试时最容易忽略的两个点

很多 PHP 接口看似“收不到数据”，其实卡在这两处：

• 没检查小程序控制台 Network 面板里真实发出的 Content-Type 和 Request Payload 内容（不是看代码写的，是看实际发的）
• PHP 文件开头有空白字符或 BOM 头，导致 json_decode 解析失败却没报错（json_last_error() 返回 JSON_ERROR_SYNTAX，但常被忽略）

建议所有接收 JSON 的 PHP 入口第一行加 if (isset($_SERVER['CONTENT_TYPE']) && strpos($_SERVER['CONTENT_TYPE'], 'application/json') !== false) { ... } 显式判断，再决定走哪条解析路径。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《微信小程序wx.request数据接收教程》文章吧，也可关注golang学习网公众号了解相关技术文章。