Spring Boot用户注册API Post端点启动失败问题求助

核心报错原因 #

启动失败的直接触发点是：

No property salvar found for type User!

Spring Data JPA无法解析UserRepository中自定义的salvar/listar/buscar/remover方法——它遵循固定的方法命名约定，同时你还存在重复定义Repository的问题，另外还有几处配置疏漏。

修复步骤 #

1. 精简Repository，复用JpaRepository内置方法 #

JpaRepository<User, Long>已经封装了所有基础CRUD能力，无需自定义同名方法：

• 保存/更新：save(User entity) → 替代你的salvar
• 查询全部：findAll() → 替代listar
• 按ID查询：findById(Long id) → 替代buscar
• 删除：delete(User entity) → 替代remover

修改后的UserRepository：

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;

public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u FROM User u WHERE u.email = ?1")
    User findByEmail(String email);
}

同时删除Security代码块中重复定义的UserRepository接口，避免类冲突。

2. 修正Controller中的方法调用 #

把userRepo.salvar(user)替换为JPA标准方法：

@PostMapping("/register")
@ResponseStatus(HttpStatus.CREATED)
public void add(@RequestBody User user) {
    userRepo.save(user);
}

另外，开发REST API建议将@Controller改为@RestController，避免后续视图解析问题。

3. 让Security Service被Spring容器管理 #

CustomUserDetailsService需要添加@Service注解，才能被Spring扫描并注入依赖：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.core.userdetails.UserDetails;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.core.userdetails.UsernameNotFoundException;
import org.springframework.stereotype.Service;

@Service
public class CustomUserDetailsService implements UserDetailsService {

    @Autowired
    private UserRepository userRepo;
    
    @Override
    public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
        User user = userRepo.findByEmail(username);
        if (user == null) {
            throw new UsernameNotFoundException("User not found");
        }
        return new CustomUserDetails(user);
    }
}

4. 补充WebSecurity基础配置（必选） #

为了让注册接口正常开放，需要添加安全配置类：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.authentication.dao.DaoAuthenticationProvider;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

@Configuration
@EnableWebSecurity
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {

    @Autowired
    private CustomUserDetailsService userDetailsService;

    @Bean
    public BCryptPasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }

    @Bean
    public DaoAuthenticationProvider authenticationProvider() {
        DaoAuthenticationProvider auth = new DaoAuthenticationProvider();
        auth.setUserDetailsService(userDetailsService);
        auth.setPasswordEncoder(passwordEncoder());
        return auth;
    }

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.authenticationProvider(authenticationProvider());
    }

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .authorizeRequests()
            .antMatchers("/register").permitAll() // 允许注册接口匿名访问
            .anyRequest().authenticated();
    }
}

重要：注册时必须加密密码，修改Controller中的保存逻辑：

@Autowired
private BCryptPasswordEncoder passwordEncoder;

@PostMapping("/register")
@ResponseStatus(HttpStatus.CREATED)
public void add(@RequestBody User user) {
    user.setPassword(passwordEncoder.encode(user.getPassword()));
    userRepo.save(user);
}

额外检查项 #

• 确保User实体的getter/setter方法完整，或用Lombok的@Data注解简化代码
• 验证PostgreSQL服务是否正常运行，数据库连接配置无误

内容的提问来源于stack exchange，提问作者Paulo Cesar Pereira da costa