代理自动配置脚本环境下无法下载Embedded MongoDB的问题排查

我之前帮不少开发者处理过类似的问题——浏览器能正常下载MongoDB包，但Spring Boot应用里用Embedded MongoDB时就抛出下载异常，核心原因就是代理配置没有在Maven、Eclipse和Embedded MongoDB三方同步，下面给你一步步的配置方案：

1. 先配置Maven的代理设置 #

Embedded MongoDB的依赖下载是通过Maven走的，所以先确保Maven能正确走代理：

• 找到你的Maven配置文件settings.xml，通常在C:\Users\你的用户名\.m2目录下，如果没有就从Maven安装目录的conf文件夹复制一份过来。
• 在<settings>标签里添加代理配置：

<proxies>
    <proxy>
        <id>http-proxy</id>
        <active>true</active>
        <protocol>http</protocol>
        <host>你的代理服务器地址</host>
        <port>代理端口</port>
        <!-- 如果代理需要认证，取消下面两行注释并填写 -->
        <!-- <username>代理用户名</username> -->
        <!-- <password>代理密码</password> -->
        <nonProxyHosts>localhost|127.0.0.1|*.your-internal-domain.com</nonProxyHosts>
    </proxy>
    <proxy>
        <id>https-proxy</id>
        <active>true</active>
        <protocol>https</protocol>
        <host>你的代理服务器地址</host>
        <port>代理端口</port>
        <!-- 如果代理需要认证，取消下面两行注释并填写 -->
        <!-- <username>代理用户名</username> -->
        <!-- <password>代理密码</password> -->
        <nonProxyHosts>localhost|127.0.0.1|*.your-internal-domain.com</nonProxyHosts>
    </proxy>
</proxies>

• 保存后，在Eclipse里右键项目 -> Maven -> Update Project，让配置生效。

2. 配置Eclipse的全局代理 #

Eclipse本身的网络请求也需要走代理，不然启动应用时的下载请求可能绕不开代理：

• 打开Eclipse，依次点击Window -> Preferences -> General -> Network Connections
• 把Active Provider改成Manual
• 在下方的HTTP和HTTPS条目里，分别填写代理主机和端口，和你浏览器用的一致
• 点击Edit按钮，在Non Proxy Hosts里添加不需要走代理的地址，比如localhost,127.0.0.1
• 点击Apply and Close，重启Eclipse确保配置生效

3. 给Embedded MongoDB显式配置代理 #

有时候Flapdoodle的Embedded MongoDB不会自动读取系统或Maven的代理，这时候需要在Spring Boot里显式指定：

方式一：通过VM启动参数配置 #

在Eclipse的Run Configuration里，找到你的Spring Boot启动项，在VM arguments里添加：

-Dhttp.proxyHost=你的代理地址 -Dhttp.proxyPort=端口号 -Dhttps.proxyHost=你的代理地址 -Dhttps.proxyPort=端口号 -Dhttp.nonProxyHosts=localhost|127.0.0.1
# 如果代理需要认证，再加下面两行
-Dhttp.proxyUser=你的代理用户名 -Dhttp.proxyPassword=你的代理密码 -Dhttps.proxyUser=你的代理用户名 -Dhttps.proxyPassword=你的代理密码

方式二：通过Spring配置类自定义下载代理 #

创建一个配置类，手动配置Embedded MongoDB的下载代理：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import de.flapdoodle.embed.mongo.config.DownloadConfigBuilder;
import de.flapdoodle.embed.mongo.config.IMongodConfig;
import de.flapdoodle.embed.mongo.config.MongodConfigBuilder;
import de.flapdoodle.embed.mongo.config.Net;
import de.flapdoodle.embed.mongo.distribution.Version;

@Configuration
public class EmbeddedMongoConfig {

    @Bean
    public IMongodConfig mongodConfig() {
        DownloadConfigBuilder downloadConfig = new DownloadConfigBuilder()
                .proxyFactory(new de.flapdoodle.embed.process.config.store.ProxyFactory() {
                    @Override
                    public java.net.Proxy createProxy() {
                        return new java.net.Proxy(java.net.Proxy.Type.HTTP, 
                                new java.net.InetSocketAddress("你的代理地址", 端口号));
                    }
                });

        return new MongodConfigBuilder()
                .version(Version.Main.PRODUCTION)
                .net(new Net(27017, false))
                .downloadConfig(downloadConfig.build())
                .build();
    }
}

如果代理需要认证，还需要在ProxyFactory里添加认证逻辑，你可以根据实际情况调整。

4. 验证配置 #

做完上面的步骤后，先清理Maven缓存：在Eclipse的Terminal里执行mvn clean install -U，然后启动你的Spring Boot应用，应该就能正常下载Embedded MongoDB的包了。

如果还是有问题，建议检查代理服务器是否允许Eclipse/Maven的请求，或者是否有防火墙拦截了相关请求。

内容的提问来源于stack exchange，提问作者de_xtr