Scala Akka HTTP多段URL路由问题排查与修复请求

问题概述 #

我用Scala、Akka HTTP和Akka Actors构建学生数据追踪API，目前只有littlerock/admins和littlerock/schools/1路由能正常工作，其余端点都返回错误The requested resource could not be found。

期望实现的API端点 #

• 所有学区管理员 - GET: http://localhost:8080/littlerock/admins
• 学校详情 - GET: http://localhost:8080/littlerock/schools/{schoolId}
• 某学校所有学生 - GET: http://localhost:8080/littlerock/schools/{schoolId}/students
• 学生详情 - GET: http://localhost:8080/littlerock/schools/{schoolId}/students/{studentId}
• 某学生的所有同班同学 - GET: http://localhost:8080/littlerock/schools/{schoolId}/students/{studentId}/classmates
• 学生的同班同学详情 - GET: http://localhost:8080/littlerock/schools/{schoolId}/students/{studentId}/classmates/{classmateId}

原路由代码 #

val schoolRoutes: Route =
  pathPrefix("littlerock") {
  concat(

  pathPrefix("admins") {
    concat(
      pathEnd {
        concat(
          get {
            complete("District administrators.")
          })
      })
  },

  pathPrefix("schools") {
    concat(
      path(Segment) { name =>
        concat(
          pathEnd {
          get {
            rejectEmptyResponse {
                complete("A school's details.")
            }
          }
          },
          path("students") {
            concat(
              pathEnd {
                get {
                  rejectEmptyResponse {
                    complete("All students")
                  }
                }
              },
              path(Segment) { name =>
                concat(
                  pathEnd {
                  get {
                    rejectEmptyResponse {
                      complete("A student's details")
                    }
                  }},
                  path("classmates") {
                    concat(
                      pathEnd {
                        get {
                          rejectEmptyResponse {
                            complete("A student's classmates.")
                          }
                        }
                      },
                      path(Segment) { name =>
                        concat(
                          get {
                            rejectEmptyResponse {
                              complete("A classmate's details.")
                            }
                        })
                      }
                    )
                  }
                )
              }
            )
          }
        )
    })
  }
)}

问题原因及修复方案 #

原路由的核心问题是嵌套路径匹配逻辑错误：在schools/{schoolId}层级下，用path("students")会精确匹配到该路径段，无法识别后续的students/{studentId}等子路径，应该改用pathPrefix来支持嵌套子路径。同理，classmates部分也需要调整路径匹配方式，同时简化冗余的嵌套结构。

修复后的代码如下：

val schoolRoutes: Route =
  pathPrefix("littlerock") {
    concat(
      // 学区管理员路由
      pathPrefix("admins") {
        pathEndOrSingleSlash {
          get {
            complete("District administrators.")
          }
        }
      },

      // 学校相关路由
      pathPrefix("schools" / Segment) { schoolId =>
        concat(
          // 学校详情
          pathEndOrSingleSlash {
            get {
              rejectEmptyResponse {
                complete(s"School details for ID: $schoolId")
              }
            }
          },
          // 学校下的学生相关路由
          pathPrefix("students") {
            concat(
              // 某学校所有学生
              pathEndOrSingleSlash {
                get {
                  rejectEmptyResponse {
                    complete(s"All students in school $schoolId")
                  }
                }
              },
              // 特定学生相关路由
              pathPrefix(Segment) { studentId =>
                concat(
                  // 学生详情
                  pathEndOrSingleSlash {
                    get {
                      rejectEmptyResponse {
                        complete(s"Student details: $studentId in school $schoolId")
                      }
                    }
                  },
                  // 学生的同班同学相关路由
                  pathPrefix("classmates") {
                    concat(
                      // 某学生的所有同班同学
                      pathEndOrSingleSlash {
                        get {
                          rejectEmptyResponse {
                            complete(s"Classmates of student $studentId in school $schoolId")
                          }
                        }
                      },
                      // 同班同学详情
                      pathPrefix(Segment) { classmateId =>
                        pathEndOrSingleSlash {
                          get {
                            rejectEmptyResponse {
                              complete(s"Details of classmate $classmateId for student $studentId in school $schoolId")
                            }
                          }
                        }
                      }
                    )
                  }
                )
              }
            )
          }
        )
      }
    )
  }

关键修复点 #

1. 替换path为pathPrefix：pathPrefix允许匹配当前路径段及后续子路径，解决了原代码无法识别嵌套端点的问题。
2. 简化嵌套层级：将schools与Segment直接组合为pathPrefix("schools" / Segment)，减少冗余嵌套，让路由结构更清晰。
3. 使用pathEndOrSingleSlash：同时兼容路径末尾带斜杠和不带斜杠的请求，提升API的兼容性。
4. 优化参数命名：将重复的name参数改为schoolId、studentId、classmateId，增强代码可读性。

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