BioJava出现java.net.ConnectException连接超时问题求助

问题原因 #

1. 本地文件路径不符合预期：BioJava的PDBFileReader默认会按[根目录]/[PDB ID前两位]/[PDB ID].pdb（或.cif）的结构查找文件。如果你的1lvz.pdb直接放在C:/PDB files根目录，或者文件名/后缀不匹配，会导致程序找不到本地文件，触发内置的自动下载逻辑。
2. 环境变量未生效：日志中Could not read dir from system property PDB_DIR or environment variable PDB_DIR的警告说明，你设置的PDB_DIR未被当前Java进程读取到——可能是设置后未重启IDE/终端，或者环境变量的作用域（系统/用户）不对。
3. 默认行为自动下载：PDBFileReader的内置逻辑是“本地找不到就自动从RCSB下载”，这是框架默认行为，无需手动编写下载代码就会执行。

解决方法 #

1. 调整本地文件目录结构

将PDB文件放到符合BioJava预期的路径下：

• 以1lvz为例，PDB格式文件需放在 C:/PDB files/1l/1lvz.pdb；若为mmCIF格式，则放在C:/PDB files/1l/1lvz.cif。

2. 代码层面强制读取本地

修改代码，禁用自动下载，强制仅读取本地文件：

package org.example;
import org.biojava.nbio.structure.*;
import org.biojava.nbio.structure.io.PDBFileReader;
import org.biojava.nbio.structure.io.FetchBehavior;

public class BioJavaPDBHelloWorld {
    public static void main(String[] args) {
        try {
            PDBFileReader pdbReader = new PDBFileReader();
            pdbReader.setPath("C:/PDB files");
            // 禁用自动下载，仅读取本地文件
            pdbReader.setFetchBehavior(FetchBehavior.FETCH_LOCAL_ONLY);
            // 若本地为PDB格式而非mmCIF，需添加此配置
            pdbReader.setUseMmCif(false);
            
            Structure structure = pdbReader.getStructureById("1lvz");
            
            System.out.println("PDB ID: " + structure.getPDBCode());
            System.out.println("Title: " + structure.getPDBHeader().getTitle());
            System.out.println("ID : " + structure.getId());
        } catch (Exception e){
            e.printStackTrace();
        }
    }
}

3. 确保PDB_DIR环境变量生效

• Windows系统：设置PDB_DIR环境变量后，必须重启IDE或终端，让Java进程读取到新的环境变量。
• IDEA临时配置：在Run Configuration的VM options中添加-DPDB_DIR=C:/PDB files，直接指定系统属性，无需依赖环境变量。

4. 验证本地文件有效性

确认C:/PDB files下的目标文件存在、文件名正确（小写PDB ID，如1lvz.pdb），且文件未损坏。

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