refactor: 인증 정보 argumentResolver가 long siteUserId를 주입하도록 #396

nayonsoso · 2025-07-23T01:47:40Z

작업 내용

너무 오래된 이슈라 자괴감이 드는 이슈입니다 🥲

(히스토리 설명) SiteUser 객체를 Controller → Service 로 전달하면, Service 코드에서는
siteUserRepository.findById().orElseThrow(USER_NOT_FOUND);와 같은 중복코드 없이
SiteUser를 POJO처럼 다룰 수 있을 것이라 생각했습니다.
하지만 아무리 편리하다고 하더라도, 도메인 객체를 Controller에서 넘겨주는건 DIP 위반입니다.
그리고 양방향 연관계에 대한 리팩터링을 하기 전에는, SiteUser와 연관된 객체에서 LazyInitialization도 발생해 변경의 필요성을 느꼈습니다.
(다행히 LazyInitialization 관련 코드는 수연님이 연관관계 PR에서 없애주셨습니다. 감사합니다🙇🏻‍♀️)
Controller에서 Service레이어로 전달되던 SiteUser 객체를 long siteUserId로 바꿉니다.
그랬더니 수많은 곳에 siteUserRepository.findById().orElseThrow(USER_NOT_FOUND)라는 중복코드가 발생하더라고요 🥲
대안으로 siteUserRepository.findByIdOrThrow()라는 default 함수를 디스코드에 제안드렸습니다!
검토 부탁드립니다.

특이 사항

기본적으로 argumentResolver는 Object 형식을 반환합니다.
그리고 사용자가 선언한 형식으로 형변환하여 넣어주는 구조입니다.
따라서 long 형태로 선언한다면, NPE가 발생할 위험이 있습니다.
이를 방지하기 위해 타입이 원시타입이면 required = true로 여기게 하는 코드를 작성했습니다.

- 추가로, 반복되던 mocking 으로 가독성을 해치던 것을 해결

coderabbitai · 2025-07-23T01:47:48Z

"""

Walkthrough

컨트롤러 및 서비스 계층에서 인증 사용자 파라미터 변경
- 모든 컨트롤러와 서비스 계층에서 기존에 @AuthorizedUser SiteUser로 주입받던 인증 사용자를 @AuthorizedUser long siteUserId 또는 Long siteUserId로 변경하였습니다.
- 이에 따라 서비스 계층 메서드 시그니처도 일제히 SiteUser 객체 대신 사용자 ID(primitive 혹은 래퍼 타입)를 받도록 수정되었습니다.
- 컨트롤러에서 서비스 호출 시에도 객체가 아닌 ID만 전달합니다.
인증 사용자 리졸버(AuthorizedUserResolver) 리팩토링
- 리졸버가 더 이상 SiteUser 객체를 반환하지 않고, 인증된 사용자의 ID(Long)만 반환하도록 변경되었습니다.
- 파라미터 타입이 long/Long일 때만 동작하며, primitive 타입의 경우 항상 필수(required)로 간주합니다.
- 내부적으로 인증 정보에서 사용자 ID만 추출합니다.
서비스 계층에서 사용자 조회 및 예외 처리 추가
- 서비스 계층에서 사용자 ID를 받아 직접 SiteUserRepository로부터 사용자를 조회합니다.
- 사용자가 존재하지 않을 경우 CustomException(USER_NOT_FOUND)를 발생시킵니다.
- 이 패턴은 커뮤니티, 뉴스, 멘토, 점수, 지원 등 모든 도메인 서비스에 일괄 적용되었습니다.
테스트 코드 전체 일괄 반영
- 테스트 코드 내 모든 서비스/컨트롤러 호출에서 SiteUser 객체 대신 user.getId()를 전달하도록 변경하였습니다.
- 인증 사용자 리졸버 테스트는 실제 리플렉션 기반으로 파라미터 정보를 얻도록 개선되었으며, primitive 타입 처리 케이스가 추가되었습니다.
- 각 도메인별 서비스 테스트, 컨트롤러 테스트, 동시성 테스트, 예외 테스트 등 전반적으로 동일한 방식으로 수정되었습니다.
기타
- 더 이상 사용하지 않는 SiteUser import 구문이 모두 제거되었습니다.
- 일부 테스트에서는 사용자 객체 대신 ID를 사용하도록 필드 타입이 변경되었습니다.
- 서비스 내부에서 ID 기반으로만 로직이 동작하도록 관련 코드가 일관되게 수정되었습니다.

Estimated code review effort

4 (~90분)

전체적으로 컨트롤러, 서비스, 리졸버, 테스트 등 다수의 파일과 메서드 시그니처가 변경되었습니다.
변경 범위는 넓으나, 패턴이 일관되고 로직 자체의 복잡도는 높지 않습니다.
리뷰 시 메서드 호출 체인, 예외 처리, 인증 리졸버 동작, 테스트 케이스의 일관성 등을 꼼꼼히 확인해야 하므로 60~120분 정도의 시간이 소요될 것으로 예상됩니다.

Suggested reviewers

wibaek
Gyuhyeok99
whqtker
"""

📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 0840718 and f31acca.

📒 Files selected for processing (1)

src/main/java/com/example/solidconnection/community/board/controller/BoardController.java (1 hunks)

🚧 Files skipped from review as they are similar to previous changes (1)

src/main/java/com/example/solidconnection/community/board/controller/BoardController.java

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

GitHub Check: build

✨ Finishing Touches

📝 Generate Docstrings

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

Review comments: Directly reply to a review comment made by CodeRabbit. Example:
- I pushed a fix in commit <commit_id>, please review it.
- Explain this complex logic.
- Open a follow-up GitHub issue for this discussion.
Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
- @coderabbitai explain this code block.
- @coderabbitai modularize this function.
PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
- @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
- @coderabbitai read src/utils.ts and explain its main purpose.
- @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
- @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

@coderabbitai pause to pause the reviews on a PR.
@coderabbitai resume to resume the paused reviews.
@coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
@coderabbitai full review to do a full review from scratch and review all the files again.
@coderabbitai summary to regenerate the summary of the PR.
@coderabbitai generate docstrings to generate docstrings for this PR.
@coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
@coderabbitai resolve resolve all the CodeRabbit review comments.
@coderabbitai configuration to show the current CodeRabbit configuration for the repository.
@coderabbitai help to get help.

Other keywords and placeholders

Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (`.coderabbit.yaml`)

You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
Please see the configuration documentation for more information.
If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

Visit our Documentation for detailed information on how to use CodeRabbit.
Join our Discord Community to get help, request features, and share feedback.
Follow us on X/Twitter for updates and announcements.

coderabbitai

Actionable comments posted: 0

🧹 Nitpick comments (2)

src/main/java/com/example/solidconnection/siteuser/service/MyPageService.java (1)
38-39: 💡 코드 중복 개선 제안을 고려해보세요

현재 siteUserRepository.findById().orElseThrow(() -> new CustomException(USER_NOT_FOUND)) 패턴이 반복되고 있습니다. PR 목표에서 언급한 findByIdOrThrow() 디폴트 메서드 추가를 통해 이런 중복을 줄일 수 있겠습니다.
// SiteUserRepository에 추가할 디폴트 메서드 예시
default SiteUser findByIdOrThrow(Long id) {
    return findById(id).orElseThrow(() -> new CustomException(USER_NOT_FOUND));
}
Also applies to: 49-50
src/main/java/com/example/solidconnection/application/service/ApplicationQueryService.java (1)

4-4: 서비스 계층 리팩토링이 올바르게 구현되었습니다.

다음 변경사항들이 정확히 적용되었습니다:

메서드 시그니처에서 SiteUser 파라미터를 long siteUserId로 변경

SiteUserRepository 의존성 추가 및 USER_NOT_FOUND 에러 코드 임포트

각 메서드에서 사용자 ID로 SiteUser 조회 로직 추가

현재 siteUserRepository.findById().orElseThrow(USER_NOT_FOUND) 패턴이 반복되고 있는데, PR 목표에서 언급한 findByIdOrThrow() 기본 레포지토리 메서드가 추가되면 코드 중복을 효과적으로 해결할 수 있을 것입니다.

Also applies to: 13-13, 37-37, 44-47, 62-64, 128-130

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 60ee7b9 and a176925.

📒 Files selected for processing (45)

src/main/java/com/example/solidconnection/application/controller/ApplicationController.java (2 hunks)
src/main/java/com/example/solidconnection/application/service/ApplicationQueryService.java (5 hunks)
src/main/java/com/example/solidconnection/application/service/ApplicationSubmissionService.java (3 hunks)
src/main/java/com/example/solidconnection/auth/controller/AuthController.java (1 hunks)
src/main/java/com/example/solidconnection/auth/service/AuthService.java (3 hunks)
src/main/java/com/example/solidconnection/common/resolver/AuthorizedUserResolver.java (1 hunks)
src/main/java/com/example/solidconnection/community/comment/controller/CommentController.java (1 hunks)
src/main/java/com/example/solidconnection/community/comment/service/CommentService.java (5 hunks)
src/main/java/com/example/solidconnection/community/post/controller/PostController.java (2 hunks)
src/main/java/com/example/solidconnection/community/post/service/PostCommandService.java (5 hunks)
src/main/java/com/example/solidconnection/community/post/service/PostLikeService.java (4 hunks)
src/main/java/com/example/solidconnection/community/post/service/PostQueryService.java (2 hunks)
src/main/java/com/example/solidconnection/mentor/controller/MentorController.java (1 hunks)
src/main/java/com/example/solidconnection/mentor/controller/MentorMyPageController.java (1 hunks)
src/main/java/com/example/solidconnection/mentor/controller/MentoringController.java (1 hunks)
src/main/java/com/example/solidconnection/mentor/service/MentorMyPageService.java (3 hunks)
src/main/java/com/example/solidconnection/mentor/service/MentorQueryService.java (1 hunks)
src/main/java/com/example/solidconnection/news/controller/NewsController.java (2 hunks)
src/main/java/com/example/solidconnection/news/service/NewsCommandService.java (4 hunks)
src/main/java/com/example/solidconnection/s3/controller/S3Controller.java (1 hunks)
src/main/java/com/example/solidconnection/s3/service/S3Service.java (2 hunks)
src/main/java/com/example/solidconnection/score/controller/ScoreController.java (1 hunks)
src/main/java/com/example/solidconnection/score/service/ScoreService.java (6 hunks)
src/main/java/com/example/solidconnection/siteuser/controller/MyPageController.java (1 hunks)
src/main/java/com/example/solidconnection/siteuser/service/MyPageService.java (3 hunks)
src/main/java/com/example/solidconnection/university/controller/UnivApplyInfoController.java (1 hunks)
src/main/java/com/example/solidconnection/university/service/LikedUnivApplyInfoService.java (4 hunks)
src/main/java/com/example/solidconnection/university/service/UnivApplyInfoRecommendService.java (1 hunks)
src/test/java/com/example/solidconnection/application/service/ApplicationQueryServiceTest.java (7 hunks)
src/test/java/com/example/solidconnection/application/service/ApplicationSubmissionServiceTest.java (4 hunks)
src/test/java/com/example/solidconnection/auth/service/AuthServiceTest.java (3 hunks)
src/test/java/com/example/solidconnection/common/resolver/AuthorizedUserResolverTest.java (4 hunks)
src/test/java/com/example/solidconnection/community/comment/service/CommentServiceTest.java (15 hunks)
src/test/java/com/example/solidconnection/community/post/service/PostCommandServiceTest.java (11 hunks)
src/test/java/com/example/solidconnection/community/post/service/PostLikeServiceTest.java (4 hunks)
src/test/java/com/example/solidconnection/community/post/service/PostQueryServiceTest.java (1 hunks)
src/test/java/com/example/solidconnection/concurrency/PostLikeCountConcurrencyTest.java (1 hunks)
src/test/java/com/example/solidconnection/concurrency/ThunderingHerdTest.java (2 hunks)
src/test/java/com/example/solidconnection/mentor/service/MentorMyPageServiceTest.java (3 hunks)
src/test/java/com/example/solidconnection/mentor/service/MentorQueryServiceTest.java (7 hunks)
src/test/java/com/example/solidconnection/news/service/NewsCommandServiceTest.java (1 hunks)
src/test/java/com/example/solidconnection/score/service/ScoreServiceTest.java (6 hunks)
src/test/java/com/example/solidconnection/siteuser/service/MyPageServiceTest.java (6 hunks)
src/test/java/com/example/solidconnection/university/service/LikedUnivApplyInfoServiceTest.java (9 hunks)
src/test/java/com/example/solidconnection/university/service/UnivApplyInfoRecommendServiceTest.java (4 hunks)

🧠 Learnings (3)

src/test/java/com/example/solidconnection/mentor/service/MentorMyPageServiceTest.java (1)