一、项目编码不一致（编译时出现中文乱码或 “非法字符: ‘\ufeff’”）
- 解决办法：
- 统一编码为 UTF-8：IDE 中设置（IDEA：File→Settings→Editor→File Encodings；Eclipse：Window→Preferences→General→Workspace）。
- Maven/Gradle 配置编码：pom.xml添加<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>；Gradle 在build.gradle中设置compileJava.options.encoding = ‘UTF-8’。
- 转换文件编码：用记事本或 IDE 将 GBK 编码文件另存为 UTF-8（无 BOM）。
二、项目结构错误（IDE 提示 “源文件夹不是 Java 项目”）
- 解决办法：
- 标记源目录：IDEA 右键src/main/java→Mark Directory as→Sources Root；Eclipse 右键目录→Build Path→Use as Source Folder。
- 重新导入项目：删除 IDE 配置文件（.idea/.project），通过 Maven/Gradle 重新导入（Import Project→选择pom.xml/build.gradle）。
- 检查pom.xml打包类型：确保为jar或war（<packaging>jar</packaging>），避免非 Java 项目类型。
三、IDE 插件缺失（如 Spring 项目提示 “无法识别 @Controller 注解”）
- 解决办法：
- 安装对应框架插件：IDEA 安装 “Spring Boot”“Spring MVC” 插件；Eclipse 安装“Spring Tool Suite” 。
- 启用注解处理：IDEA→Settings→Build→Compiler→Annotation Processors→勾选 “Enable annotation processing”。
- 更新 IDE 版本：旧版 IDE 可能不支持新框架特性，升级至最新稳定版。
四、端口被占用（启动项目时提示 “Address already in use: bind”）
- 解决办法：
- 查找占用进程：Windows 用netstat -ano | findstr “端口号”，Linux/macOS 用lsof -i:端口号，找到 PID 后结束进程。
- 修改项目端口：Spring Boot 在application.properties中设置server.port=8081；Tomcat 在server.xml中修改Connector的port。
- 配置随机端口：开发环境用server.port=0（Spring Boot），自动分配未占用端口。
五、配置文件路径错误（提示 “Could not find config.properties”）
- 解决办法：
- 检查配置文件位置：确保放在src/main/resources目录下（Maven/Gradle 标准资源目录）。
- 使用相对路径加载：代码中用ClassLoader.getResourceAsStream(“config.properties”)，避免硬编码绝对路径。
- 清理并重新构建：IDE 可能未将资源文件复制到输出目录，执行mvn clean compile同步资源。