该错误源于直接实例化 roach 蜘蛛类，而未通过 roach 门面启动；必须使用 `roach::startspider()` 方法触发完整生命周期，否则 laravel 容器无法解析内部依赖（如 `$method` 参数）。
在 Laravel 中集成 RoachPHP 进行网页爬取时，一个常见误区是将蜘蛛类（如 RoachDocsSpider）当作普通控制器或服务直接调用或实例化——这会导致 Laravel 服务容器无法正确解析 Roach 内部构造函数所需的参数（例如 string $method），从而抛出 Unresolvable dependency resolving [Parameter #0 [<required> string $method] in class RoachPHP\Http\Request #8 的异常。
根本原因在于：Roach 蜘蛛不是设计为手动 new 实例的类，而是需由 Roach 自身的启动机制（Roach::startSpider()）驱动。该方法会初始化完整的运行时上下文（包括请求工厂、中间件栈、事件分发器等），确保所有依赖被正确注入。
✅ 正确做法如下：
-
确保已正确安装并发布配置（参考 Roach Laravel 文档）：
立即学习“PHP免费学习笔记（深入）”；
Workflow Decomposer下载工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
composer require roach-php/roach-laravel php artisan vendor:publish --provider="RoachPHP\Laravel\RoachServiceProvider"
-
在控制器或命令中启动蜘蛛（切勿 new 实例）：
// 在控制器方法中（例如 App\Http\Controllers\SpiderController.php） use RoachPHP\Roach; use App\Spiders\RoachDocsSpider; // 建议将蜘蛛移至 app/Spiders 目录 public function crawl() { Roach::startSpider(RoachDocsSpider::class); return response()->json(['status' => 'Spider started']); } -
调试建议：在 parse() 中添加 dd() 验证响应内容（如答案所示），但仅用于开发阶段：
public function parse(Response $response): \Generator { $title = $response->filter('h1')->text(); $subtitle = $response->filter('main > div:nth-child(2) p:first-of-type')->text(); // 开发时临时调试，确认选择器有效 \dd($title, $subtitle); // 注意：dd() 会终止执行，上线前务必移除 yield $this->item([ 'title' => $title, 'subtitle' => $subtitle, ]); }
⚠️ 注意事项：
- 不要将蜘蛛类放在 App\Http\Controllers 下——推荐统一存放于 app/Spiders 并使用 PSR-4 自动加载；
- 确保蜘蛛类 use RoachPHP\Spider\BasicSpider 且继承关系正确；
- 若使用自定义中间件、扩展类或重写 makeRequest()，需确保所有依赖类型提示与容器注册一致；
- 生产环境请禁用 dd()/dump()，改用日志记录（Log::info()）。
总结：RoachPHP 的设计哲学是“声明式蜘蛛 + 命令式启动”。只要坚持通过 Roach::startSpider() 启动，并避免手动构造蜘蛛实例，即可彻底规避此类依赖解析失败问题。
