🌟 Feature : FCM 알림 초기 세팅

[pjs1710]

🍀 이슈 번호

• 🌟 Feature : FCM 알림 시스템 설정 세팅 작업 #159

---

✅ 작업 사항

1️⃣ FCM 토큰 Mapping

가상의 FCM 더미 토큰을 이용하여 memberId와 token을 매핑하는 작업 진행.

해당 FCM 더미 토큰 부분은 FE에서 EAS 빌드 후의 환경에서 Firebase에 토큰을 받아온 후, 해당 토큰을 받는 작업이 필요합니다.

위의 참조에 해당하는 엔드포인트는 POST 방식의 ~/api/fcm/register/token으로, 해당 엔드포인트로 FE에서 토큰과 로그인 한 유저의 memberId를 보내주게되면 정상적으로 토큰이 등록이 됩니다.

---

[등록 요청]

[Redis 등록 상황]

2️⃣ FCM 알림 전송/삭제

매핑된 FCM 토큰은 Redis에 저장하였습니다.

❓왜 Redis에 저장하였는가?

→ 토큰을 저장 및 가져오는 방식에 있어서 RDB를 사용하기에는 메모리 작업 비용이 클 것으로 예상되어 Redis를 이용해 저장하고 가져오는 방식을 채택하였습니다.

→ 또한 알림의 경우 동일 토큰에 대해 반복적인 요청이 잦기 때문에, 캐시를 이용한 데이터 조회가 필요합니다. 이에 적절한 데이터베이스 저장 방식인 Redis를 사용했습니다.

매핑된 토큰과 FCM 공식 Document를 참고하여 정형화된 Json 데이터 형식을 따라 알림을 전송하였습니다.

참고 공식문서 : https://firebase.google.com/docs/cloud-messaging/send-message?hl=ko#customize-messages-across-platforms

또한 현재 더미 FCM 토큰 데이터를 PostMan으로 전송하여 알림을 발송하게 되면 Firebase에서 올바른 Token 형식이 아니라는 오류를 반환합니다. 해당 부분은 1️⃣에 해당하는 참조에 해당하는 오류로, 해당 내용을 참고하시면 됩니다.

---

[FCM 서버에 알림 전송 요청]

[BE 서버 알림 전송 요청 로그]

2025-11-12 04:15:40 [http-nio-9000-exec-5] INFO  c.m.s.d.n.business.FcmManager - | ==== 알림 전송 시작 ==== | memberId : 5d9d8b47-1a82-4381-a5e8-f1bc06332759, title : 테스트 알림 전송입니다, body : 안녕하세요 테스트 전송입니다
2025-11-12 04:15:41 [http-nio-9000-exec-5] ERROR c.m.s.d.n.helper.FcmUtilImpl - FCM 메세지 전송 실패 : The registration token is not a valid FCM registration token
com.google.firebase.messaging.FirebaseMessagingException: The registration token is not a valid FCM registration token

[올바른 형식의 Token 필요]

Caused by: com.google.api.client.http.HttpResponseException: 400 Bad Request
POST https://fcm.googleapis.com/v1/projects/shoot-pointer-project/messages:send
{
  "error": {
    "code": 400,
    "message": "The registration token is not a valid FCM registration token",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.firebase.fcm.v1.FcmError",
        "errorCode": "INVALID_ARGUMENT"
      }
    ]
  }
}

---

⌨ 기타

@tkv00 님께서는 현재 알림 전송 실패에 대한 PR이 FE에서의 빌드 후 토큰 전송에 대한 프로세스가 추후 진행될 예정임을 인지해주시면 될 것 같습니다.

또한 각 알림 이벤트 발생(하이라이트 생성 완료, 랭킹 갱신 등)에 대한 기능 구현은 다음 이슈에서 다루겠습니다.

[tkv00]

수고하셨습니다~!!

[tkv00]

/gemini

[gemini-code-assist]

It looks like you tried to invoke a command. To use Gemini Code Assist commands, please use /gemini <command> or @gemini-code-assist <command>. For example, to get a code review, you would type /gemini review or @gemini-code-assist review.

Here is a list of available commands:

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.