TP6接口接收数组参数易出错，根本原因是框架按固定顺序合并不同来源数据（JSON/POST优先于路由/GET），需严格区分数据来源及调用对应方法：JSON用json()、路由用param()、表单用input()、文件用file()，嵌套数组须显式声明类型如input('user.tags/a')。
TP6 接口接收数组参数时容易出错，根本原因在于框架对不同来源数据的合并逻辑和参数绑定顺序有明确规则，并非简单按变量名匹配。关键要分清数据来源（路由、GET、POST、JSON、FormData）及其优先级，否则会出现参数错位、覆盖或丢失。
区分数据来源，避免混合传参干扰
TP6 的 param() 方法会自动合并 GET、POST、PUT、PATHINFO（路由）等多处参数，但合并顺序固定：先索引数组（如 JSON 或 POST 原始体），再关联数组（如路由参数、GET 查询串）。若同时发送路由参数 /user/123 和 JSON 主体 {"name":"张三","age":25}，$this->request->param() 返回的数组中，索引键 0、1 可能来自 JSON 解析结果，而 id（对应 123）才是路由值——此时控制器方法若写成 function edit($id, $name)，$name 很可能被误赋为索引 0 的值，而非 JSON 中的 name 字段。
- 纯路由参数（如
route::get('user/:id', 'user/edit')）→ 用方法参数直接接收或$this->request->param('id') - 表单提交（
application/x-www-form-urlencoded）→ 用input('data/a')或input('data/a/s')安全取嵌套字段 - JSON 请求（
application/json）→ 必须显式调用$this->request->json('data.a')，input()默认不解析 - FormData（含文件）→ 用
$this->request->file('avatar')取文件，其他字段用input('title')，禁用手动设置Content-Type
接收嵌套数组的正确写法
前端传 { "user": { "name": "李四", "tags": ["a", "b"] } }，TP6 不支持 input('user') 直接返回完整子数组（除非加点号后缀）。必须明确声明结构：
-
input('user.name/s')→ 取字符串，自动过滤 -
input('user.tags/a')→ 显式声明要数组，即使前端传错类型也返回空数组而非报错 -
input('user.')→ 注意末尾点号，可批量取user下所有字段为关联数组 - 若用 JSON 方式传，统一走
json('user.tags/a')，更可靠
多文件上传时的数组陷阱
FormData 多文件不是传一个数组对象，而是多次 append 同名键：
- ❌ 错误：
formData.append('files', [f1, f2])→ 后端收到字符串"[object File],[object File]" - ✅ 正确：
files.forEach(f => formData.append('files', f))→ 后端用$this->request->file('files')得到文件对象数组 - 注意：TP6 的
file()方法对同名多文件默认返回数组，无需额外处理
验证与调试建议
遇到数组参数接收异常，先看原始输入再排查：
- 打印
$this->request->getInputData()查原始请求体（含 JSON 字符串） - 打印
$this->request->param()看框架合并后的最终参数结构 - 对 JSON 请求，单独测
$this->request->json()是否为 null（说明解析失败，可能是 Content-Type 不规范或 JSON 格式错误） - 检查 PHP 配置：若 FormData 上传为空，确认
file_uploads=On且post_max_size >= upload_max_filesize + 其他字段大小
