错误1316/1311主因是注册表残留，需删除HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft、HKEY_CURRENT_USER\SOFTWARE\JavaSoft及所有含java/jdk/jre的无效卸载项，并卸载控制面板中全部Java程序、清空Program Files下的Java文件夹。

Java JDK 安装失败时出现的错误代码，多数不是安装包本身问题，而是系统环境干扰或残留导致。关键不是反复重试，而是定位具体错误类型，针对性清理和重装。下面按常见错误代码归类说明处理方式：

错误 1316、1311：注册表项冲突

这类错误通常提示“指定的账户已存在”或“找不到源文件”，根本原因是旧版 JDK 卸载不彻底，注册表中残留 JavaSoft 或 Oracle 相关键值。

• 打开注册表编辑器（Win + R → 输入 regedit），依次删除：
  HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft
  HKEY_CURRENT_USER\SOFTWARE\JavaSoft
  同时搜索关键词 “jdk”、“jre”、“java”，删掉所有非系统必需、路径指向 Java 安装目录的条目
• 卸载控制面板中所有 Java 相关程序（含 JRE、JDK、Java Auto Updater）
• 手动删除 C:\Program Files\Java 及 C:\Program Files (x86)\Java 下全部文件夹

错误 2502 / 2503：权限被拦截

安装程序无法写入系统目录或注册表，常因权限不足或安全软件主动拦截。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 右键 JDK 安装程序 → 以管理员身份运行
• 临时关闭 Windows Defender 实时防护（设置 → 更新和安全 → Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 关闭实时保护）
• 同时退出第三方杀软（如火绒、360、腾讯电脑管家）和输入法（尤其百度输入法曾被多次反馈引发闪退）

错误 “向导被中断” 或直接闪退

界面无明确报错，安装过程突然终止，多由后台程序干扰或路径/磁盘问题引起。

立即学习“Java免费学习笔记（深入）”；

• 按 Ctrl + Shift + Esc 打开任务管理器，结束所有非必要进程（聊天工具、优化软件、云同步客户端等）
• 确认系统架构匹配：右键“此电脑”→属性，若为 64 位系统才可装 64 位 JDK；32 位系统必须下载 32 位版本
• 安装路径避免中文、空格、特殊符号，推荐使用纯英文短路径，例如：C:\jdk24（不是 C:\Program Files\Java\jdk-24.0.2）
• 检查 C 盘剩余空间是否 ≥500MB；若不足，清理后再试

安装完成但命令行无效（javac 不识别）

这不属于安装失败，但常被误认为安装出错。本质是环境变量未生效或配置错误。

• JAVA_HOME 必须指向 JDK 根目录（如 C:\jdk24），不能指向 bin 或 jre 子目录
• Path 中需添加 %JAVA_HOME%\bin，且该条目应置于最上方，避免被旧版路径覆盖
• 修改后必须重启电脑（仅关掉 CMD 不够），再新开命令行验证：
  echo %JAVA_HOME% → 显示路径正确
  where java 和 where javac → 两者输出路径一致且含 jdk24
  java -version && javac -version → 两行版本号完全相同