如何配置TestContainers Neo4j容器，使其每次使用固定端口？

要让Neo4j TestContainers固定使用同一Bolt端口，核心是通过端口绑定将容器内部默认的Bolt端口（7687）映射到宿主机的固定端口，具体实现如下：

Java 实现示例 #

方式1：使用withFixedPortBinding #

直接指定宿主机端口与容器内部Bolt端口的绑定关系：

// 定义你要固定的宿主机端口
int fixedBoltPort = 7687;

Neo4jContainer<?> neo4jContainer = new Neo4jContainer<>("neo4j:5.12")
        .withPassword("your-password")
        .withFixedPortBinding(fixedBoltPort, 7687); // 宿主机端口 -> 容器内部Bolt端口

neo4jContainer.start();
// 此时Bolt URI就是 bolt://localhost:7687

方式2：使用addFixedExposedPort #

另一种等价的端口绑定写法：

int fixedBoltPort = 7687;

Neo4jContainer<?> neo4jContainer = new Neo4jContainer<>("neo4j:5.12")
        .withPassword("your-password")
        .addFixedExposedPort(fixedBoltPort, 7687);

注意事项 #

• 确保宿主机的固定端口未被其他进程占用，否则容器启动会抛出端口冲突异常。
• 如果需要并行运行测试或多线程执行测试用例，固定端口可能导致资源冲突，这种场景更推荐使用TestContainers的随机端口机制，通过容器提供的getBoltUrl()动态获取URI：

Neo4jContainer<?> neo4jContainer = new Neo4jContainer<>("neo4j:5.12")
        .withPassword("your-password");
neo4jContainer.start();
// 动态获取带随机端口的Bolt URI
String dynamicBoltUri = neo4jContainer.getBoltUrl();

内容的提问来源于stack exchange，提问作者m.zemlyanoi