uber/fx로 시작하는
Go 의존성 주입

fx.Provide(
    config.New,
    database.New,
    NewArticleUsecase,
)

New(cfg *config.Config) (*sql.DB, error)
     ↑ 필요            ↑ 제공

go get go.uber.org/fx

fx는 메서드가 많아 헷갈리기 쉽다. 다음 슬라이드의 지도를 먼저 펼쳐두고, 각 장에서 하나씩 실전 예제로 채워 나간다.

app := fxtest.New(t,
    // Provide: 생성자를 등록만 한다. 즉시 실행되지 않는다.
    fx.Provide(
        NewLogger,        // Logger 반환
        NewMysqlUserRepo, // UserRepository 반환 (Logger 필요)
        NewUserService,   // *UserService 반환 (UserRepository 필요)
    ),
    // Invoke: 여기서 비로소 그래프가 조립된다
    fx.Invoke(func(s *UserService) { svc = s }),
)

// Provide만 있고 Invoke가 없는 앱
→ 생성자는 단 하나도 호출되지 않는다. 앱은 조용히 뜨고 조용히 끝난다.

// cmd/main.go
app := fx.New(
    fx.Provide(
        config.New,              // *config.Config
        database.New,            // *sql.DB          (*config.Config 필요)
        NewEcho,                 // *echo.Echo

        // 익명 함수도 그대로 생성자가 된다 — 타입만 맞으면 된다
        func(cfg *config.Config) time.Duration {
            return time.Duration(cfg.Context.Timeout) * time.Second
        },

        article.NewArticleHandler,         // Echo, UseCase 필요
        article.NewArticleUsecase,         // Repo, AuthorRepo, Duration 필요
        article.NewMysqlArticleRepository, // DB 필요
        author.NewMysqlAuthorRepository,   // DB 필요
    ),
    fx.Invoke(registerHooks),   // 서버 시작
)

화살표는 의존 방향이다. fx는 이 그래프를 선언 없이 매개변수·반환 타입만으로 만든다. 순환이 생기면 앱 시작 시점에 어디가 물렸는지 알려준다.

func registerHooks(lifecycle fx.Lifecycle, e *echo.Echo, cfg *config.Config) {
    lifecycle.Append(fx.Hook{
        OnStart: func(context.Context) error {
            fmt.Println("Starting server")
            go e.Start(cfg.Server.Address)
            return nil
        },
        OnStop: func(context.Context) error {
            fmt.Println("Stopping server")
            return nil
        },
    })
}

// 로깅 데코레이터: 기존 UserRepository 를 래핑
type loggingUserRepo struct {
    inner  UserRepository
    logger Logger
}

func (r *loggingUserRepo) FindByID(id int) string {
    r.calls = append(r.calls, fmt.Sprintf("FindByID(%d)", id))
    return r.inner.FindByID(id)   // 원본 호출
}

app := fxtest.New(t,
    fx.Provide(NewLogger, NewMysqlUserRepo, NewUserService),
    fx.Decorate(func(repo UserRepository, logger Logger) UserRepository {
        return &loggingUserRepo{inner: repo, logger: logger}
    }),
)

app := fxtest.New(t,
    fx.Provide(NewLogger, NewMysqlUserRepo, NewUserService),
    fx.Invoke(func(svc *UserService) { /* ... */ }),
)
defer app.RequireStop()
app.RequireStart()

app := fxtest.New(t,
    fx.Provide(NewLogger, NewMysqlUserRepo, NewUserService),

    // 실제 UserRepository 를 Mock 으로 교체
    fx.Replace(fx.Annotate(&mockUserRepo{}, fx.As(new(UserRepository)))),

    fx.Invoke(func(svc *UserService) {
        result := svc.repo.FindByID(1)
        // result == "mock-user-1"
    }),
)

• fx는 생성자의 매개변수·반환 타입만으로 의존성 그래프를 만든다 — 조립 순서를 코드에서 지운다
• Provide는 lazy 등록, Invoke는 eager 실행. Invoke가 없으면 아무 일도 일어나지 않는다
• Lifecycle은 2단계다 — New에서 훅을 등록하고, Start에서 본문을 실행한다
• 앱이 커지면 Module로 묶고, Decorate로 덧씌우고, name/group으로 구분하고, Private으로 감춘다
• 테스트는 fxtest + Replace(fx.As 잊지 말 것) + Populate
• 모든 것을 fx로 관리하지 않는다. 수명주기가 있는 컴포넌트에 집중할 때 가장 빛난다