CI4服务容器不支持跨模块远程调用，仅支持同进程内跨命名空间手动注册或外部HTTP/API调用；跨模块服务需在Config\Services.php中显式定义工厂方法，或使用CURLRequest发起HTTP请求。
CI4服务容器本身不支持跨模块调用
CodeIgniter 4 的服务容器（\Config\Services）是单应用进程内、单命名空间作用域的，它不提供跨模块（如跨 Composer 包、跨独立子项目、跨微服务）的服务发现或远程调用能力。所谓“跨模块调用服务”，在 CI4 原生语境中实际只有两种可行路径：同进程内跨命名空间加载 或 外部 HTTP/API 调用。混淆这两者是多数人踩坑的起点。
同进程内调用其他模块的服务类（需手动注册）
如果你的“模块”是同一 CI4 应用下的子目录（比如 app/Modules/Api/Services/OrderService.php），且已正确配置自动加载（PSR-4），那它本质仍是本地类——服务容器不会自动识别它，必须显式注册。
- 在
App\Config\Services.php中添加静态工厂方法：
public static function orderService($getShared = true)
{
if ($getShared) {
return self::getSharedInstance('orderService');
}
return new \App\Modules\Api\Services\OrderService();
}
- 之后在控制器中即可通过
service('orderService')获取实例 - 若该服务依赖数据库或会话，务必在其构造函数中调用
parent::__construct()（如果继承了Controller）或手动获取服务：$this->db = \Config\Services::database(); - 别指望
Services::orderService()能自动解析——CI4 容器不扫描类路径，只认你写死的工厂方法
调用外部模块（如独立 API 服务）必须走 HTTP
当你说的“模块”其实是另一个部署在不同域名/IP 的服务（例如 auth-service.example.com 或本地 http://localhost:8001），那就和 CI4 容器无关了——你只是个 HTTP 客户端。
- 用
\CodeIgniter\HTTP\CURLRequest发起请求，而非尝试注入远程服务：
$client = \Config\Services::curlrequest();
$response = $client->post('https://auth-service.example.com/api/token', [
'form_params' => ['user_id' => $id]
]);
- 不要在构造函数里同步调用远程服务——会阻塞整个请求，且违反服务容器“快速实例化”的设计前提
- 若需复用连接或统一错误处理，可封装一个
RemoteAuthService类，但它的实例仍应通过service('remoteAuth')注册，内部逻辑仍是 HTTP 调用 - 跨域、超时、重试、JWT 持有等，都得自己实现；CI4 不提供服务网格或 RPC 层
容易被忽略的关键点
很多人卡在“为什么 service('xxx') 找不到我的类”，根本原因不是写法错，而是：服务名必须与工厂方法名完全一致，且该方法必须存在于 \Config\Services 类中。没有自动注册，没有注解扫描，没有 YAML 配置文件。另外，所有跨模块共享的类（尤其是模型或服务）必须确保其命名空间能被 Composer 自动加载器识别——检查 composer.json 的 "autoload": {"psr-4": {...}} 是否覆盖了你的模块路径。
