PHPUnit数据提供者必须返回二维数组或Iterator对象，每项为匹配测试参数的数组；不支持多个@dataProvider，需合并数据或拆分测试方法；禁止在提供者中执行I/O操作。
PHPUnit数据提供者（dataProvider）怎么写才不报错
直接用 @dataProvider 注解但测试跑不起来？常见原因是返回值类型不对——必须返回二维数组或实现了 Iterator 的对象，且每项必须是可解包为函数参数的数组。
比如测试一个校验邮箱格式的函数：isValidEmail(string $email): bool，数据提供者得这样写：
public function emailProvider(): array
{
return [
['test@example.com', true],
['invalid-email', false],
['', false],
['a@b.c', true],
];
}注意：键名可省略（用数字索引），但不能混用字符串键和数字键；每组数据长度必须匹配被测方法参数个数。
- 返回
null或一维数组 → 报Invalid data provider return value - 某组数据少一个参数 → PHPUnit 解包失败，抛出
ArgumentCountError - 用
yield返回生成器时，记得加返回类型声明Generator，否则 PHP 8+ 可能报类型警告
多个数据提供者怎么共用同一个测试方法
PHPUnit 不支持单个测试方法挂多个 @dataProvider，硬写两个注解只会生效第一个。真要覆盖多类场景，有三个实际可用方案：
立即学习“PHP免费学习笔记（深入）”；
- 把不同来源的数据合并到一个提供者里，用清晰的键名或注释区分类别，比如
['valid_emails' => [...], 'edge_cases' => [...]]，再在测试里用self::assertTrue()等断言分路径验证 - 拆成多个测试方法，各自绑定一个提供者，名字体现差异：如
testValidEmails()和testInvalidEmails() - 用
yield from合并多个生成器（PHP 7.4+），例如在提供者里依次yield from $this->validCases(); yield from $this->emptyCases();
别试图用 require_once 动态加载外部 PHP 数组文件来“绕过”限制——那会让 IDE 无法跳转、类型推导失效，调试时也看不到原始数据结构。
数据提供者里调用数据库或外部服务行不行
不行。数据提供者函数在测试用例实例化前就被执行（属于静态上下文），此时 $this 不可用，setUp() 也没运行，任何依赖 DI 容器、数据库连接或文件系统操作都会失败。
典型错误现象：Call to a member function query() on null 或 Undefined variable: this。
- 需要 DB 数据？提前在
setUpBeforeClass()中查好、存成静态属性，提供者里只读取该静态数组 - 需要随机数据？用
random_int()或uniqid()生成纯计算型数据，避开 I/O - 想复用真实业务数据？导出为 JSON/PHP 数组文件，用
include加载，确保内容是字面量，不含 new 或函数调用
记住：dataProvider 函数本质是“数据编译期”，不是“测试运行期”。它越轻量，测试启动越快，CI 流水线越稳。
为什么测试方法参数顺序和数据提供者数组顺序必须严格一致
因为 PHPUnit 用 call_user_func_array() 解包数组，靠位置而非名称匹配参数。哪怕你给测试方法参数写了默认值或类型提示，也不会影响解包逻辑。
例如这个测试：
/**
* @dataProvider userProvider
*/
public function testUserCreation(string $name, int $age, ?string $email = null): void
{
// ...
}对应提供者返回 ['Alice', 25] 是合法的（$email 会取默认 null），但返回 [25, 'Alice'] 就会触发 TypeError —— 因为 PHP 强制按位置传参，$name 收到整数 25，类型不匹配。
- 参数带默认值没关系，只要前面的位置对得上
- 使用命名参数（PHP 8.0+）在测试方法定义里无效，dataProvider 不支持
- IDE 通常不会在提供者数组里标出参数名，靠人肉核对顺序，建议在提供者函数名或注释里写明字段含义，比如
// [name, age, email]
最易忽略的一点：当测试方法签名后期调整（比如加了新参数），所有关联的 dataProvider 都得同步改，否则错位问题往往只在 CI 上暴露，本地可能因巧合“碰对”而漏掉。
