Java中System.getProperty("user.home")返回null及Scanner读文件报错的解决方法

你遇到的System.getProperty("user.home")返回null、Scanner读取文件抛出FileNotFoundException是强关联的连锁问题，不需要优先在项目设置中手动硬编码配置该系统属性，返回null本质是JVM读取操作系统用户环境的链路出现异常，而非项目配置漏项。

• JVM启动参数存在空值覆盖：启动脚本、IDE运行配置、容器启动命令中人为添加了-Duser.home=的空值参数，直接冲掉了JVM默认自动读取的取值
• 操作系统环境变量配置异常：Windows下的USERPROFILE变量、Linux/macOS下的HOME变量被设为空值，或运行Java进程的账号没有权限读取这类用户级环境变量
• 特殊运行场景适配缺失：将Java程序注册为无窗口系统服务、基于最小化容器镜像运行、使用裁剪版第三方JRE时，基础运行环境没有预置用户目录相关的环境配置
• 老旧JDK版本的兼容Bug：部分早期版本的Windows适配JDK，在非管理员权限启动进程时，无法正确读取用户目录路径

• 先验证JVM实际加载的路径类系统属性，不要仅单独测试user.home，执行以下代码遍历打印关联属性值：

  System.getProperties().entrySet()
      .stream()
      .filter(entry -> entry.getKey().toString().matches(".*(user|home|dir).*"))
      .forEach(entry -> System.out.println(entry.getKey() + " = " + entry.getValue()));
  

  若输出中user.home、user.dir、user.name多个关联属性同时为null，可确认是环境读取链路整体失效，不是单个属性的配置问题。
• 排查启动链路的参数覆盖：检查所有启动入口（IDE运行配置、shell启动脚本、systemd服务配置、容器启动命令），删除手动添加的空-Duser.home参数，让JVM恢复默认的系统属性读取逻辑。
• 修复操作系统层面的环境变量异常：
  • Windows系统：确认当前登录账号的用户环境变量USERPROFILE取值为正确的用户目录路径（如C:\Users\你的用户名），不存在空值或拼写错误，修改完成后重启终端、IDE再启动程序
  • Linux/macOS系统：在终端执行echo $HOME确认返回的用户目录路径正常，若路径为空，为运行Java进程的账号配置正确的HOME环境变量即可
• 特殊场景的兜底配置：如果是系统服务、容器这类无法修改底层系统配置的场景，可以在JVM启动参数中显式传入正确的用户目录路径（如-Duser.home=/opt/app/user_home），无需修改项目代码即可解决属性为null的问题。
• 关联解决Scanner的FileNotFoundException：待user.home能返回正确值后，不要在代码中硬写跨环境失效的绝对文件路径，优先通过System.getProperty("user.home")拼接目标文件的相对路径，同时确认目标文件的读取权限、路径拼写正确，即可消除文件找不到的异常。

内容的提问来源于stack exchange，提问作者Filip Zahradník