AI写代码香是真香，但这4个坑差点让我通宵debug

大家好我是小悟。项目概述项目名称智能任务管理系统SmartTaskFlow项目背景我需要为一个小型团队开发一个轻量级的任务管理后端系统支持任务的创建、分配、状态跟踪和统计。作为AI编程的实践者我决定借助AI完成从需求分析到代码实现的全过程。技术栈Java 17, Spring Boot 3.x, H2 Database, Maven第一部分详细过程描述阶段一需求分析与AI辅助我的动作向AI描述项目需求要求它帮助梳理功能点。AI提示词示例“我需要开发一个任务管理系统的后端请帮我梳理核心功能需求按优先级排序并给出技术选型建议。”AI输出P0功能用户注册/登录、任务的CRUD、任务状态流转P1功能任务分配、按状态统计P2功能任务评论、标签系统技术建议Spring Boot JPA H2内存数据库我的收获AI帮助我快速收敛需求避免了过度设计。阶段二项目初始化与AI生成配置AI提示词“生成一个Spring Boot 3项目的pom.xml包含Web、JPA、H2、Lombok依赖Java版本17。”AI生成代码?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.1.5/version /parent groupIdcom.smarttask/groupId artifactIdtaskflow/artifactId version1.0.0/version properties java.version17/java.version /properties dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /dependency dependency groupIdcom.h2database/groupId artifactIdh2/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies /project阶段三实体层设计AI提示词“设计User和Task两个实体User包含id、用户名、邮箱Task包含标题、描述、状态、优先级、负责人ID。使用JPA注解Lombok简化代码。”AI生成代码// User.java package com.smarttask.entity; import jakarta.persistence.*; import lombok.Data; import lombok.NoArgsConstructor; import lombok.AllArgsConstructor; Entity Table(name users) Data NoArgsConstructor AllArgsConstructor public class User { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; Column(unique true, nullable false) private String username; Column(unique true, nullable false) private String email; } // Task.java package com.smarttask.entity; import jakarta.persistence.*; import lombok.Data; import lombok.NoArgsConstructor; import lombok.AllArgsConstructor; import java.time.LocalDateTime; Entity Table(name tasks) Data NoArgsConstructor AllArgsConstructor public class Task { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; Column(nullable false) private String title; private String description; Enumerated(EnumType.STRING) private TaskStatus status; Enumerated(EnumType.STRING) private TaskPriority priority; Column(name assignee_id) private Long assigneeId; Column(name created_at) private LocalDateTime createdAt; Column(name updated_at) private LocalDateTime updatedAt; } // TaskStatus.java package com.smarttask.entity; public enum TaskStatus { TODO, IN_PROGRESS, DONE, ARCHIVED } // TaskPriority.java package com.smarttask.entity; public enum TaskPriority { LOW, MEDIUM, HIGH, URGENT }问题与修正AI最初没有添加创建时间和更新时间字段我要求补充后它添加了上述字段并建议使用PrePersist和PreUpdate。阶段四Repository与Service层AI提示词“为Task创建JpaRepository接口并编写TaskService包含创建任务、更新状态、分配负责人、按状态统计的方法。”AI生成代码// TaskRepository.java package com.smarttask.repository; import com.smarttask.entity.Task; import com.smarttask.entity.TaskStatus; import org.springframework.data.jpa.repository.JpaRepository; import java.util.List; public interface TaskRepository extends JpaRepositoryTask, Long { ListTask findByAssigneeId(Long userId); ListTask findByStatus(TaskStatus status); long countByStatus(TaskStatus status); } // TaskService.java package com.smarttask.service; import com.smarttask.entity.Task; import com.smarttask.entity.TaskStatus; import com.smarttask.entity.TaskPriority; import com.smarttask.repository.TaskRepository; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.time.LocalDateTime; import java.util.Map; import java.util.HashMap; Service RequiredArgsConstructor public class TaskService { private final TaskRepository taskRepository; Transactional public Task createTask(String title, String description, Long assigneeId, TaskPriority priority) { Task task new Task(); task.setTitle(title); task.setDescription(description); task.setAssigneeId(assigneeId); task.setPriority(priority); task.setStatus(TaskStatus.TODO); task.setCreatedAt(LocalDateTime.now()); task.setUpdatedAt(LocalDateTime.now()); return taskRepository.save(task); } Transactional public Task updateTaskStatus(Long taskId, TaskStatus newStatus) { Task task taskRepository.findById(taskId) .orElseThrow(() - new RuntimeException(Task not found)); task.setStatus(newStatus); task.setUpdatedAt(LocalDateTime.now()); return taskRepository.save(task); } Transactional public Task assignTask(Long taskId, Long userId) { Task task taskRepository.findById(taskId) .orElseThrow(() - new RuntimeException(Task not found)); task.setAssigneeId(userId); task.setUpdatedAt(LocalDateTime.now()); return taskRepository.save(task); } public MapTaskStatus, Long getTaskStatistics() { MapTaskStatus, Long stats new HashMap(); for (TaskStatus status : TaskStatus.values()) { stats.put(status, taskRepository.countByStatus(status)); } return stats; } }阶段五Controller与API暴露AI提示词“为TaskService生成REST Controller包含POST /tasks创建任务、PUT /tasks/{id}/status更新状态、PUT /tasks/{id}/assign分配负责人、GET /tasks/stats获取统计。”AI生成代码// TaskController.java package com.smarttask.controller; import com.smarttask.entity.Task; import com.smarttask.entity.TaskStatus; import com.smarttask.entity.TaskPriority; import com.smarttask.service.TaskService; import lombok.RequiredArgsConstructor; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.*; import java.util.Map; RestController RequestMapping(/api/tasks) RequiredArgsConstructor public class TaskController { private final TaskService taskService; PostMapping public ResponseEntityTask createTask(RequestBody CreateTaskRequest request) { Task task taskService.createTask( request.getTitle(), request.getDescription(), request.getAssigneeId(), request.getPriority() ); return ResponseEntity.ok(task); } PutMapping(/{id}/status) public ResponseEntityTask updateStatus( PathVariable Long id, RequestParam TaskStatus status) { Task task taskService.updateTaskStatus(id, status); return ResponseEntity.ok(task); } PutMapping(/{id}/assign) public ResponseEntityTask assignTask( PathVariable Long id, RequestParam Long userId) { Task task taskService.assignTask(id, userId); return ResponseEntity.ok(task); } GetMapping(/stats) public ResponseEntityMapTaskStatus, Long getStats() { return ResponseEntity.ok(taskService.getTaskStatistics()); } } // CreateTaskRequest.java package com.smarttask.controller; import lombok.Data; import com.smarttask.entity.TaskPriority; Data public class CreateTaskRequest { private String title; private String description; private Long assigneeId; private TaskPriority priority; }阶段六全局异常处理与验证AI提示词“添加全局异常处理处理任务不存在和参数校验错误的情况。”AI生成代码// GlobalExceptionHandler.java package com.smarttask.exception; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.*; RestControllerAdvice public class GlobalExceptionHandler { ExceptionHandler(RuntimeException.class) public ResponseEntityErrorResponse handleRuntimeException(RuntimeException ex) { ErrorResponse error new ErrorResponse(NOT_FOUND, ex.getMessage()); return ResponseEntity.status(HttpStatus.NOT_FOUND).body(error); } ExceptionHandler(IllegalArgumentException.class) public ResponseEntityErrorResponse handleIllegalArgument(IllegalArgumentException ex) { ErrorResponse error new ErrorResponse(BAD_REQUEST, ex.getMessage()); return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(error); } } // ErrorResponse.java package com.smarttask.exception; import lombok.AllArgsConstructor; import lombok.Data; Data AllArgsConstructor public class ErrorResponse { private String code; private String message; }阶段七测试与验证AI提示词“编写TaskService的单元测试测试创建任务和更新状态的方法。”AI生成代码// TaskServiceTest.java package com.smarttask.service; import com.smarttask.entity.Task; import com.smarttask.entity.TaskStatus; import com.smarttask.entity.TaskPriority; import com.smarttask.repository.TaskRepository; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; import org.mockito.InjectMocks; import org.mockito.Mock; import org.mockito.junit.jupiter.MockitoExtension; import java.util.Optional; import static org.junit.jupiter.api.Assertions.*; import static org.mockito.ArgumentMatchers.any; import static org.mockito.Mockito.*; ExtendWith(MockitoExtension.class) class TaskServiceTest { Mock private TaskRepository taskRepository; InjectMocks private TaskService taskService; Test void createTask_Success() { Task mockTask new Task(); mockTask.setId(1L); mockTask.setTitle(Test Task); mockTask.setStatus(TaskStatus.TODO); when(taskRepository.save(any(Task.class))).thenReturn(mockTask); Task result taskService.createTask(Test Task, Desc, 1L, TaskPriority.MEDIUM); assertNotNull(result); assertEquals(Test Task, result.getTitle()); assertEquals(TaskStatus.TODO, result.getStatus()); verify(taskRepository, times(1)).save(any(Task.class)); } Test void updateTaskStatus_TaskNotFound_ThrowsException() { when(taskRepository.findById(99L)).thenReturn(Optional.empty()); assertThrows(RuntimeException.class, () - { taskService.updateTaskStatus(99L, TaskStatus.DONE); }); } }第二部分详细步骤总结步骤1定义清晰的AI协作目标不要只说“帮我写个系统”而是提供具体功能、技术栈、边界条件使用结构化提示词角色任务约束示例步骤2从高层到低层逐级实现需求 → 实体 → Repository → Service → Controller → 异常处理每一步都让AI生成代码然后人工审查步骤3善用AI的迭代能力第一版生成后主动提出优化需求“添加校验”、“增加日志”要求AI解释关键代码逻辑加深理解步骤4建立完整的测试思维让AI同时生成测试代码不要跳过异常场景的测试步骤5代码审查与重构AI生成的代码风格统一但需要检查是否符合团队规范主动要求AI重构“把业务逻辑从Controller移到Service”第三部分详细总结优势与成功点开发效率提升约3-5倍从零到可运行API包含CRUD统计异常处理人工约需4小时AI辅助下1小时完成减少了语法错误和样板代码编写时间代码质量出奇稳定AI遵循了常见的设计模式Repository-Service-Controller自动考虑了事务边界、RESTful规范命名规范统一注释清晰学习成本降低对于不熟悉的框架如Spring Boot新特性AI可以直接生成正确示例通过观察AI生成的代码快速掌握最佳实践文档同步生成虽然本文未展示但可以让AI同时生成Swagger/OpenAPI文档Controller、Service的方法签名天然成为文档挑战与坑点AI容易“幻觉”不存在的API有时会使用已废弃的方法或错误的包路径如把jakarta.persistence写成javax.persistence对策运行前让AI确认使用的版本号和API稳定性业务逻辑错误需人工发现AI生成的统计方法countByStatus没问题但它不知道你需要按负责人分组统计对策分步骤对话让AI逐步细化需求安全与权限完全缺失上述代码没有任何认证授权直接暴露全部API对策必须人工添加Spring Security或要求AI生成基础权限骨架集成测试覆盖率不足AI生成的测试以单元测试为主缺少端到端测试对策明确要求“生成使用SpringBootTest的集成测试”改进方向建立AI代码生成模板库将成功的提示词保存为模板后续项目复用结合代码审查工具用SonarQube扫描AI生成的代码发现潜在问题再回馈给AI修正引入AI驱动的测试生成让AI基于代码自动生成边界测试、压力测试用例团队共享最佳提示词例如“生成Spring Data JPA动态查询支持多条件筛选和分页”最后AI编程不是“一键完成项目”而是人机协作的新范式。最有效的角色分配是AI负责样板代码、重复逻辑、基础CRUD、配置生成、测试骨架人类负责需求拆解、架构决策、非功能性需求安全/性能/扩展性、边界处理、最终验收这个任务管理系统的完整代码在AI协助下从启动到第一版可运行API含4个核心接口异常处理单元测试实际耗时约50分钟。如果完全手工编写预估需要3-4小时。效率提升明显但前提是你要知道自己想要什么并能快速识别AI生成的错误。谢谢你看我的文章既然看到这里了如果觉得不错随手点个赞、转发、在看三连吧感谢感谢。那我们下次再见。您的一键三连是我更新的最大动力谢谢山水有相逢来日皆可期谢谢阅读我们再会我手中的金箍棒上能通天下能探海