本文详解如何在spring boot中正确创建基于路径变量的rest端点，实现按member_no精确查询数据库记录，并指出sql参数绑定与注解使用的常见错误。
本文详解如何在spring boot中正确创建基于路径变量的rest端点，实现按member_no精确查询数据库记录，并指出sql参数绑定与注解使用的常见错误。
在Spring Boot中构建RESTful API时，若需根据唯一标识（如 memberno）查询单条或多条匹配记录，必须确保路径变量正确注入、SQL语句安全绑定参数，以及DAO方法逻辑完整。以下为完整、可运行的实现方案。
✅ 正确的控制器层实现
需使用 @PathVariable 显式声明路径参数，并建议添加 required = true 和类型校验：
@GetMapping("/searchDataByMember/{memberno}")
public List<MyData> searchDataByMember(@PathVariable("memberno") Integer memberno) {
if (memberno == null || memberno <= 0) {
throw new IllegalArgumentException("Invalid memberno: must be a positive integer");
}
return myServiceDAO.findDataByMemberNo(memberno);
}⚠️ 注意：
@PathVariable不可省略——仅写int memberno会导致Spring无法自动解析URL路径中的值，参数将为默认值（如0），进而导致查询无结果或全表扫描风险。
✅ 安全的DAO层SQL参数化查询
原代码中 "where member_no=memberno?" 是严重错误：memberno? 被当作字面列名而非占位符。应使用 ? 占位符 + 参数数组 实现预编译，防止SQL注入并确保类型匹配：
@Repository
public class MyServiceDAO {
@Autowired
private JdbcTemplate jdbcTemplate;
@Transactional(readOnly = true)
public List<MyData> findDataByMemberNo(Integer memberNo) {
String sql = "SELECT member_no, dt, name, drnumber, docid, contact " +
"FROM demooutput WHERE member_no = ?";
return jdbcTemplate.query(sql, new DataRowMapper(), memberNo);
}
// 其他方法（如 findAll）保持不变...
}✅ 关键改进点：
- 使用
?占位符，由jdbcTemplate.query(sql, rowMapper, args...)自动绑定； - 第三个参数
memberNo作为实际值传入，类型与数据库字段一致（建议DB中member_no为INT或BIGINT）； - 推荐显式指定列名而非
SELECT *，提升可维护性与性能。
? 补充建议与最佳实践
-
异常处理：在Controller中添加
@ExceptionHandler捕获EmptyResultDataAccessException，返回404更符合REST规范； -
DTO封装：避免直接返回实体类（如
MyData），建议用DTO解耦API与数据层； -
日志与监控：对关键查询添加日志（如
log.debug("Querying member_no={}", memberNo)）便于排查； -
单元测试示例：
@Test void shouldReturnDataForValidMemberNo() { List<MyData> result = controller.searchDataByMember(12345); assertThat(result).isNotEmpty(); }
通过以上改造，/searchDataByMember/12345 将精准返回对应成员的所有记录，兼顾安全性、可读性与生产可用性。
