在开发spring boot restful api时，我们通常会在本地开发环境中，通过http://localhost:port/api/...的形式使用postman等工具进行测试。这种方式便捷高效，但在某些场景下，例如需要从另一台计算机访问api，或者希望在本地模拟真实域名环境进行测试时，localhost就无法满足需求。本文将介绍两种实现非localhost测试的策略。
1. 利用hosts文件进行本地域名模拟测试
hosts文件是操作系统用于将域名映射到IP地址的一个文本文件。通过修改这个文件，我们可以在本地将一个自定义的域名指向127.0.0.1（本地回环地址），从而在不部署到外部服务器的情况下，模拟通过域名访问本地应用。
1.1 hosts文件原理与配置
hosts文件位于不同操作系统的特定路径：
- Windows: C:\Windows\System32\drivers\etc\hosts
- macOS/Linux: /etc/hosts
要将一个自定义域名（例如magicServer.com）指向本地，你需要以管理员权限打开hosts文件，并添加以下条目：
127.0.0.1 magicServer.com
保存文件后，当你尝试在浏览器或Postman中访问http://magicServer.com时，操作系统会首先查找hosts文件，发现magicServer.com被映射到127.0.0.1，从而将请求发送到本地计算机。
1.2 Spring Boot应用端口配置
为了更真实地模拟通过域名访问，通常我们会希望省略URL中的端口号（例如http://magicServer.com/api/all-users而不是http://magicServer.com:8095/api/all-users）。HTTP协议的默认端口是80，HTTPS的默认端口是443。因此，我们可以将Spring Boot应用的监听端口设置为80。
在application.properties或application.yml文件中进行配置：
application.properties:
server.port=80
application.yml:
server: port: 80
配置完成后，重启Spring Boot应用。现在，你就可以通过http://magicServer.com/api/all-users这样的URL在本地测试你的API了。
1.3 优点与局限性
优点：
- 无需外部服务器： 完全在本地进行，无需购买域名或服务器。
- 快速模拟： 能够快速验证应用在域名环境下的行为。
- 开发便利： 可以在开发阶段模拟生产环境的URL结构。
局限性：
- 仅限本地机器： hosts文件的修改只对当前机器生效，其他计算机无法通过magicServer.com访问你的API。
- 端口占用： 端口80或443可能被其他服务占用，需要确保Spring Boot应用能够成功绑定。
2. 部署至互联网服务器进行真实环境测试
当需要从其他计算机访问API，或进行真正的外部环境测试时，将Spring Boot应用部署到一台互联网服务器并配置一个真实域名是不可避免的。
2.1 基础设施准备
- 互联网服务器： 购买一台云服务器（如AWS EC2, Azure VM, 阿里云ECS, 腾讯云CVM等）或虚拟私人服务器（VPS）。确保服务器具备公共IP地址。
- 注册域名： 在域名注册商处（如GoDaddy, Namecheap, 阿里云万网等）注册一个你自己的域名。
2.2 应用部署与网络配置
-
打包Spring Boot应用： 使用Maven或Gradle将Spring Boot应用打包成可执行的JAR文件。
# Maven mvn clean package
生成的JAR文件通常位于target目录下。
-
部署应用到服务器： 将JAR文件上传到你的互联网服务器上。可以通过SSH工具（如SCP或SFTP）进行传输。 在服务器上，使用java -jar命令运行你的应用：
java -jar your-spring-boot-app.jar
为了让应用在后台持续运行，通常会使用nohup或systemd等工具。
-
配置DNS A记录： 登录你的域名注册商的DNS管理界面。添加一条A记录，将你的域名（例如magicServer.com或api.magicServer.com）指向你的互联网服务器的公共IP地址。
- 类型： A
- 主机记录/名称： @ (表示主域名) 或 api (表示子域名)
- 记录值/IP地址： 你的服务器的公共IP地址
- TTL： 默认值即可
服务器防火墙/安全组配置： 确保服务器的防火墙或云服务商的安全组已开放Spring Boot应用监听的端口（例如80, 443, 或你自定义的端口）。如果你的应用监听端口是8095，你需要确保该端口对外部是可访问的。
2.3 优点与注意事项
优点：
- 真实环境测试： 完全模拟用户通过互联网访问API的场景。
- 全球可访问： 任何连接到互联网的设备都可以通过域名访问你的API。
- 分布式测试： 方便进行负载测试、性能测试等。
注意事项：
- DNS传播时间： DNS记录更改后，全球DNS服务器更新需要一定时间（通常几分钟到几小时不等）。
- 安全性： 在生产环境中，强烈建议为API启用HTTPS（通过SSL/TLS证书），以加密通信并保护数据安全。可以使用Let's Encrypt等免费证书服务。
- 服务器维护： 需要负责服务器的操作系统、Java环境、应用本身的维护和监控。
- 成本： 涉及服务器和域名的购买费用。
3. 总结与最佳实践
选择哪种测试策略取决于你的具体需求和测试阶段：
- 开发阶段的快速模拟： 当你只想在本地模拟域名访问，或者需要验证特定域名下的行为时，修改hosts文件是一种简单有效的方案。
- 跨设备或真实环境测试： 当你需要从其他计算机访问你的API，或者进行性能、负载、集成测试时，将应用部署到互联网服务器并配置真实域名是唯一的选择。
无论采用哪种方式，理解其背后的原理和限制都至关重要。在任何面向公众的API部署中，务必优先考虑安全性，特别是使用HTTPS来保护数据传输。
