2026Technology-Competition/data/demo-pmd/reports/AccessorAndIpDemo-review.md

代码审查报告

文件: data\demo-pmd\src\com\demo\bestpractices\extra\AccessorAndIpDemo.java 语言: java 耗时: 131.2s 分析工具: pmd

---

总计: 17 | 错误: 3 | 警告: 13 | 建议: 1

静态分析 · 14 个问题

• 🔴 pmd:ClassWithOnlyPrivateConstructorsShouldBeFinal L10 该类只有私有构造函数，应声明为 final。 建议: 将类声明为 final，防止继承。如果类需要被实例化，应将私有构造函数改为包私有或 public。
• 🔴 pmd:SystemPrintln L42 使用了 System.out/err 输出。 建议: 在生产代码中应使用日志框架（如 SLF4J）替代 System.out.println。例如定义 private static final Logger LOG = LoggerFactory.getLogger(MiscMain.class);，并调用 LOG.info("demo misc");。
• 🟡 pmd:MissingStaticMethodInNonInstantiatableClass L10 类无法被实例化，且未提供任何静态方法或静态字段。 建议: 如果该类是工具类，应声明为 final 并提供静态方法或静态字段；如果类需要实例化，则应将构造函数改为非私有。例如：声明为 final class PrivateCtor 并添加 public static PrivateCtor getInstance() { return new PrivateCtor(); }。
• 🟡 pmd:AtLeastOneConstructor L15 每个类应至少声明一个构造函数。 建议: 为 UsesPrivateCtor 添加一个显式构造函数，例如 UsesPrivateCtor() {}。
• 🟡 pmd:CommentDefaultAccessModifier L16 方法 make() 缺少默认访问修饰符的注释。 建议: 为方法添加 /* package-private */ 或 /* default */ 注释，明确默认的包私有访问权限。
• 🟡 pmd:AtLeastOneConstructor L22 每个类应至少声明一个构造函数。 建议: 为 PrivateFieldOwner 添加一个显式构造函数，例如 PrivateFieldOwner() {}。
• 🟡 pmd:ImmutableField L23 字段 secret 可以声明为 final。 建议: 如果字段在初始化后不再改变，请声明为 private final int secret = 42;。
• 🟡 pmd:CommentDefaultAccessModifier L24 方法 getSecret() 缺少默认访问修饰符的注释。 建议: 为方法添加 /* package-private */ 或 /* default */ 注释，明确默认的包私有访问权限。
• 🟡 pmd:AtLeastOneConstructor L29 每个类应至少声明一个构造函数。 建议: 为 ReadsPrivateField 添加一个显式构造函数，例如 ReadsPrivateField() {}。
• 🟡 pmd:CommentDefaultAccessModifier L30 方法 read(PrivateFieldOwner) 缺少默认访问修饰符的注释。 建议: 为方法添加 /* package-private */ 或 /* default */ 注释，明确默认的包私有访问权限。
• 🟡 pmd:MethodArgumentCouldBeFinal L30 参数 o 未被赋值，可以声明为 final。 建议: 将参数声明为 final PrivateFieldOwner o，表明方法内不会重新赋值。
• 🟡 pmd:AtLeastOneConstructor L36 每个类应至少声明一个构造函数。 建议: 为 HardCodedIpDemo 添加一个显式构造函数，例如 HardCodedIpDemo() {}。
• 🟡 pmd:CommentDefaultAccessModifier L37 字段 address 缺少默认访问修饰符的注释。 建议: 在字段声明前添加 /* package-private */ 注释，明确访问权限。
• 🟡 pmd:AvoidUsingHardCodedIP L37 不要硬编码 IP 地址 192.168.0.1。 建议: 将 IP 地址放入配置项或属性文件，在代码中通过配置读取。例如：String address = System.getProperty("app.address", "localhost");，如果需要使用 Spring 可用 @Value("${app.address}")。避免在代码中直接出现 IP 字面量。

AI 审查 · 3 条建议

• 🔴 [AI] [bug] private-constructor-access L17 外部类访问私有构造函数导致编译失败 UsesPrivateCtor.make() 中 return new PrivateCtor(); 试图在 PrivateCtor 类外部调用其私有构造函数。根据 Java 访问控制，private 构造函数只能被声明它的类内部访问，因此该代码无法通过编译。需要将构造函数访问级别提升，或改为通过私有类提供的静态工厂方法创建实例。 建议: 将 PrivateCtor 的构造函数由 private 改为包私有（或 public），例如改为 PrivateCtor()；或者保留私有构造，同时在 PrivateCtor 内添加 public static PrivateCtor getInstance()，并将调用处改为 PrivateCtor.getInstance()。
• 🟡 [AI] [bug] null-check-missing L31 read() 未对参数进行空值检查 ReadsPrivateField.read(PrivateFieldOwner o) 直接调用 o.getSecret()。若调用方传入 null，将抛出 NullPointerException。建议增加显式空值检查或使用 java.util.Objects.requireNonNull。 建议: 在方法开头添加 if (o == null) { throw new NullPointerException("o"); }；或简化为 java.util.Objects.requireNonNull(o, "o");。
• 🔵 [AI] [design] unused-field L37 字段 address 声明后从未被使用 HardCodedIpDemo.address 字段在类中没有任何方法读取或使用它。即便移除硬编码字面量，该字段本身也可能属于无用代码。如果该字段仅用于演示规则，建议删除；如果用于配置，请提供相应的 getter 或实际使用该字段，避免维护困惑。 建议: 删除该字段（类体将保持为空），或为字段添加 getter 并在业务中使用。若采用配置注入，也应确保字段被消费。