JavaFX类型转换异常求助：管理员与普通用户场景切换报错

异常信息 #

Exception in thread "JavaFX Application Thread" java.lang.ClassCastException:
class application.Admin_HomePage_Controller cannot be cast to
class application.HomePage_Controller
(application.Admin_HomePage_Controller and
application.HomePage_Controller are in unnamed module of loader 'app')
at DB.DBUtils.changeScene

需求是根据登录用户名（普通用户/管理员）实现不同的场景切换，当前changeScene方法的核心代码如下：

if(username != null) {     // if user entered username in login form
    try {
    FXMLLoader loader = new FXMLLoader(DBUtils.class.getResource(fxmlfile));
    root = loader.load();
            
    if(username == "admin") {
        Admin_HomePage_Controller adminhomepagecontroller = loader.getController();
        adminhomepagecontroller.setUserInfo(username);
}
else {
    HomePage_Controller homepagecontroller = loader.getController();
    homepagecontroller.setUserInfo(username);
}
} catch(IOException e) {
    e.printStackTrace();
}
}

请求排查类型转换异常的原因并提供解决方案。

核心原因 #

• 字符串比较逻辑错误：Java中==用于判断字符串对象的引用是否相同，而非内容相等。当用户名内容是admin但不是同一个字符串对象时，代码会错误进入else分支，此时若加载的是管理员页面的FXML（对应Admin_HomePage_Controller），强制转换为HomePage_Controller就会抛出ClassCastException。
• FXML文件与用户类型不匹配：传入的fxmlfile参数未根据用户类型切换，比如管理员登录时仍加载普通用户的FXML，或普通用户登录时加载了管理员FXML，导致控制器类型与代码中强转的类型不一致。

修复步骤 #

1. 修正字符串比较逻辑 #

将username == "admin"替换为"admin".equals(username)（已确保username不为null，避免空指针）：

if("admin".equals(username)) {
    // 管理员逻辑
} else {
    // 普通用户逻辑
}

2. 确保FXML文件与用户类型对应 #

根据用户类型传入正确的FXML路径，可在方法内部直接判断生成路径，或在调用changeScene时传入对应路径：

if(username != null) {
    try {
        // 根据用户类型选择FXML文件
        String targetFxml = "admin".equals(username) 
            ? "/application/Admin_HomePage.fxml" 
            : "/application/HomePage.fxml";
            
        FXMLLoader loader = new FXMLLoader(DBUtils.class.getResource(targetFxml));
        root = loader.load();
            
        if("admin".equals(username)) {
            Admin_HomePage_Controller adminController = loader.getController();
            adminController.setUserInfo(username);
        } else {
            HomePage_Controller userController = loader.getController();
            userController.setUserInfo(username);
        }
    } catch(IOException e) {
        e.printStackTrace();
    }
}

3. 可选优化：抽象公共接口 #

如果两个控制器都包含setUserInfo方法，可定义公共接口简化代码，避免分支判断控制器类型：

// 定义公共接口
public interface UserController {
    void setUserInfo(String username);
}

// 让两个控制器实现该接口
public class Admin_HomePage_Controller implements UserController {
    @Override
    public void setUserInfo(String username) {
        // 实现逻辑
    }
}

public class HomePage_Controller implements UserController {
    @Override
    public void setUserInfo(String username) {
        // 实现逻辑
    }
}

// 修改changeScene方法
if(username != null) {
    try {
        String targetFxml = "admin".equals(username) 
            ? "/application/Admin_HomePage.fxml" 
            : "/application/HomePage.fxml";
            
        FXMLLoader loader = new FXMLLoader(DBUtils.class.getResource(targetFxml));
        root = loader.load();
        
        UserController controller = loader.getController();
        controller.setUserInfo(username);
    } catch(IOException e) {
        e.printStackTrace();
    }
}

内容的提问来源于stack exchange，提问作者Fahmeed Mahmud Alvee