AdonisJS v5 服务无法注入控制器的原因及正确实现方法

核心错误原因 #

你遇到的注入失败问题由3个错误共同导致：

1. 自定义服务提供者加载顺序早于Adonis核心提供者，IoC容器未完成初始化就执行了绑定逻辑
2. HashService同时使用ES模块默认导出和CommonJS导出，导出格式冲突
3. 未正确使用Adonis v5的@inject装饰器触发依赖注入

修复步骤 #

1. 修正.adonisrc.json的提供者加载顺序 #

核心提供者必须优先加载，调整providers数组顺序：

{
  // 其他配置保持不变
  "providers": [
    "@adonisjs/core",
    "./providers/AppProvider"
  ]
}

2. 修正/app/Services/HashService.ts导出语法 #

删除冗余的CommonJS导出语句：

'use strict'

export default class HashService {  
  async test() {}
}

3. 修正控制器注入逻辑 #

Adonis v5依赖注入需要显式使用@inject装饰器，修正后的app/Controllers/Http/VersionsController.ts代码如下：

import { HttpContextContract } from '@ioc:Adonis/Core/HttpContext'
import { inject } from '@adonisjs/fold'
// 若已配置IoC类型声明，可替换为 import HashService from '@ioc:Service/HashService'
import HashService from 'App/Services/HashService'

@inject()
export default class VersionsController {
  constructor(protected hs: HashService) {
    console.log("hashservice is ", hs)
  }

  public async get(ctx: HttpContextContract) {
    return [
      { id: 1, title: 'a' }
    ]
  }
  
  public async put(ctx: HttpContextContract) {
    return "PUT"
  }
}

可选：配置IoC绑定类型声明（TypeScript类型支持）

如果需要通过@ioc:Service/HashService别名导入服务，在contracts目录下新建hashService.ts文件，添加类型声明：

declare module '@ioc:Service/HashService' {
  import HashService from 'App/Services/HashService'
  const serviceInstance: HashService
  export default serviceInstance
}

手动指定依赖的替代写法 #

如果你不想依赖TypeScript类型自动解析，也可以直接在@inject装饰器中传入绑定别名：

@inject(['@ioc:Service/HashService'])
export default class VersionsController {
  constructor(protected hs) {
    // hs 即为你绑定的HashService实例
  }
}

内容的提问来源于stack exchange，提问作者sbrattla