当前位置：首页 > news >正文

【沉浸式解决问题】Idea运行Junit测试中scanner无法获取控制台的输入内容

news 来源：原创 2025/6/15 7:41:28

一、问题描述

在微服务项目中写了一些自动构建脚本，其中一个实现了自动在设定的模块名下创建数据库表实体类和mapper，经过测试已经成功了，为了保险起见，在执行创建前加了一个打印文件路径，确认无误后回车继续运行，然后就卡在了这一步。
> 错误
控制台无法输入任何文字，打上断点debug确认是卡在了等待输入的那一步

二、场景还原

1. 测试类

public class CodeGeneratorTest {@Testvoid test5() {Scanner scanner = new Scanner(System.in);System.out.println("子模块目录：" + "");System.out.println("请确认以上目录正确，按回车键继续...");// 读取一个字符串直到用户按下回车键String input = scanner.nextLine();if (input.isEmpty()) {// 用户按了回车键，继续执行测试System.out.println("继续执行测试...");// 在这里继续执行你的测试逻辑} else {System.out.println("输入了额外内容，测试终止");}// 关闭scanner资源scanner.close();}
}

三、原因分析

恰巧在此之前，已经有运行成功的了，因为那个脚本比较简单，直接在类中通过main方法中运行了，简化如下：

public class Builder {public static void main(String[] args) {// 获取当前项目根目录String projectRoot = System.getProperty("user.dir");Scanner scanner = new Scanner(System.in);System.out.println("项目根目录：" + projectRoot);System.out.println("请确认以上目录正确，按回车键继续...");// 读取一个字符串直到用户按下回车键String line = scanner.nextLine();// 关闭scanner资源scanner.close();}
}

简单对比了一下就想到了是运行环境不同，@Test是在Junit测试环境中，搜索问题可以从两个角度：

@test时获取不到scanner.nextLine()
junit测试如何获取控制台输入
都找到了许多解决方法，核心的原因就是单元测试从设计的角度讲是自动化的，不应该依赖人工交互，是一个规范问题，idea默认是关闭的，而以前的eclipse是默认开启的
参考《阿里巴巴Java开发手册》中单元测试章节的内容：

【强制】单元测试应该是全自动执行的，并且非交互式的。测试用例通常是被定期执行的，执行过程必须完全自动化才有意义。输出结果需要人工检查的测试不是一个好的单元测试。单元测试中不准使用System.out来进行人肉验证，必须使用assert来验证。
【强制】保持单元测试的独立性。为了保证单元测试稳定可靠且便于维护，单元测试用例之间决不能互相调用，也不能依赖执行的先后次序。
反例：method2需要依赖method1的执行，将执行结果作为method2的输入。
【强制】单元测试是可以重复执行的，不能受到外界环境的影响。
说明：单元测试通常会被放到持续集成中，每次有代码check in时单元测试都会被执行。如果单测对外部环境（网络、服务、中间件等）有依赖，容易导致持续集成机制的不可用。
正例：为了不受外界环境影响，要求设计代码时就把SUT的依赖改成注入，在测试时用spring 这样的DI框架注入一个本地（内存）实现或者Mock实现。

四、解决方案

1. 修改idea配置文件

比较简单便捷的方法是修改idea配置文件，取消这一限制
在idea最上方的菜单栏，点击hepl -> Edit Custom Vm Options
在这里插入图片描述
就会打开idea64.exe.vmoptions配置文件，我这里因为总是打开的类太多就取消后缀名的显示了，在最后一行加上参数：

-Deditable.java.test.console=true

意思就是Java的
在这里插入图片描述
你也可以找到idea的安装目录，打开bin目录，找到idea64.exe.vmoptions文件进行修改也可以，但是要根据idea位数选择对应的文件

然后重启idea，否则配置不会生效
再测试一下，可以接收控制台内容了

不过可能对一些版本不生效，我的版本是2019.3.4
在这里插入图片描述

2. 使用main方法

通过配置文件修改是一劳永逸的，但是有可能失败，如果其他人测试也得修改配置，根据原因分析里提到的，也可以直接用main方法执行，但这样就不是单元测试了，只能用于脚本执行

public class CodeGeneratorTest {public static void main(String[] args) {Scanner scanner = new Scanner(System.in);System.out.println("子模块目录：" + "");System.out.println("请确认以上目录正确，按回车键继续...");// 读取一个字符串直到用户按下回车键String input = scanner.nextLine();// 关闭scanner资源scanner.close();}
}

3. 模拟控制台输入

如果既想测试又不想违背人工干预，只是测试交互该怎么做呢，可以通过模拟控制台输入
利用jdk自带的：System.setIn(InputStream in) 重新分配“标准”输入流，相当于不是从控制台获取数据，而是从该流中获取数据。而对于字符串可以先转为字节数组，然后转成流，ByteArrayInputStream(byte buf[])继承自InputStream，可以作为System.setIn()方法的参数。

public class CodeGeneratorTest {@Testvoid test6() {System.setIn(new ByteArrayInputStream("hello\n".getBytes()));Scanner scanner = new Scanner(System.in);String input = scanner.nextLine();scanner.close();System.out.println(input);}
}

在这里插入图片描述

五、参考文献

关于IDEA的junit单元测试Scanner输入不可用的问题(多种原因分析)
JAVA【idea中的@test使用scanner无法从键盘输入的问题】
Java JUnit测试实现控制台输入的正确姿势
用JUnit测试如何自动从控制台输入数据

喜欢的点个关注吧><！祝你永无bug！

/*_ooOoo_o8888888o88" . "88(| -_- |)O\  =  /O____/`---'\____.'  \\|     |//  `./  \\|||  :  |||//  \/  _||||| -:- |||||-  \|   | \\\  -  /// |   || \_|  ''\---/''  |   |\  .-\__  `-`  ___/-. /___`. .'  /--.--\  `. . __."" '<  `.___\_<|>_/___.'  >'"".| | :  `- \`.;`\ _ /`;.`/ - ` : | |\  \ `-.   \_ __\ /__ _/   .-` /  /
======`-.____`-.___\_____/___.-`____.-'======`=---='
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^佛祖保佑       永无BUG
*/