jruby 无法调用 java 实例方法，通常源于 java 类声明不规范：非 public 类、文件名与类名不匹配。本文详解问题根源、复现步骤及正确实践，助你快速解决 jruby 与 java 互操作中的典型陷阱。
jruby 无法调用 java 实例方法，通常源于 java 类声明不规范：非 public 类、文件名与类名不匹配。本文详解问题根源、复现步骤及正确实践，助你快速解决 jruby 与 java 互操作中的典型陷阱。
在 JRuby 中调用 Java 类方法是一种强大且常用的能力，但其前提是 Java 类必须符合 JVM 的可见性与命名规范。你遇到的 NoMethodError: undefined method 'f' for #Java::Default::T... 错误，并非 JRuby 本身缺陷，而是 Java 编译与反射机制共同作用下的预期行为。
? 根本原因解析
Java 类必须声明为
public
你定义的class T { ... }是包级私有（package-private）类——即无访问修饰符，默认仅在同一包内可见。虽然 JRuby 的T.new能成功实例化（因 JVM 允许通过反射访问包内类的构造器），但对非 public 类的实例方法调用会被 JRuby 的 Java 方法绑定机制拒绝，以确保 Java 访问控制语义的一致性。Java 源文件名必须严格匹配 public 类名
Java 规范强制要求：若类声明为public，则源文件名必须与类名完全一致（包括大小写）。因此t.java必须重命名为T.java，否则javac将报错或生成不可被正确加载的类。
✅ 正确实现步骤
① 修正 Java 源码（T.java）：
public class T { // ← 必须添加 'public'
public T() {}
public String f() {
return "abc";
}
}② 编译并确保文件名匹配：
mv t.java T.java javac T.java # 生成 T.class
③ 在 JRuby 中调用（推荐显式指定包路径，避免默认包歧义）：
立即学习“Java免费学习笔记（深入）”；
jruby -e 'java_import "T"; t = T.new; puts t.f' # 输出: abc
? 进阶建议：生产环境中应将 Java 类置于明确包中（如
com.example.T），对应文件路径为com/example/T.java，编译后通过java_import "com.example.T"引入，可彻底规避默认包（Java::Default::）带来的潜在混淆。
⚠️ 注意事项
- JRuby 9.4+ 默认启用更严格的 Java 方法解析策略，对非 public 成员的访问限制比早期版本更严格；
- 若使用 IDE 或构建工具（如 Maven），请确认编译输出的
.class文件位于 JRuby 的 classpath 中（可通过-J-cp .显式追加）； - 可用
T.java_class.declared_methods.map(&:name)在 JRuby 中调试 Java 类实际暴露的方法列表，验证可见性。
遵循 Java 语言规范是 JRuby 无缝集成 Java 生态的前提。一次正确的 public 声明与精准的文件命名，就能让跨语言调用从“报错”变为“开箱即用”。
