diff --git a/hutool-core/src/main/java/cn/hutool/core/util/ReflectUtil.java b/hutool-core/src/main/java/cn/hutool/core/util/ReflectUtil.java
index ed865f415..5a81bb816 100755
--- a/hutool-core/src/main/java/cn/hutool/core/util/ReflectUtil.java
+++ b/hutool-core/src/main/java/cn/hutool/core/util/ReflectUtil.java
@@ -300,11 +300,13 @@ public class ReflectUtil {
}
/**
- * 设置字段值
+ * 设置字段值
+ * 若值类型与字段类型不一致,则会尝试通过 {@link Convert} 进行转换
+ * 若字段类型是原始类型而传入的值是 null,则会将字段设置为对应原始类型的默认值(见 {@link ClassUtil#getDefaultValue(Class)})
*
* @param obj 对象,static字段则此处传Class
* @param fieldName 字段名
- * @param value 值,值类型必须与字段类型匹配,不会自动转换对象类型
+ * @param value 值,当值类型与字段类型不匹配时,会尝试转换
* @throws UtilException 包装IllegalAccessException异常
*/
public static void setFieldValue(Object obj, String fieldName, Object value) throws UtilException {
@@ -317,11 +319,13 @@ public class ReflectUtil {
}
/**
- * 设置字段值
+ * 设置字段值
+ * 若值类型与字段类型不一致,则会尝试通过 {@link Convert} 进行转换
+ * 若字段类型是原始类型而传入的值是 null,则会将字段设置为对应原始类型的默认值(见 {@link ClassUtil#getDefaultValue(Class)})
*
* @param obj 对象,如果是static字段,此参数为null
* @param field 字段
- * @param value 值,值类型必须与字段类型匹配,不会自动转换对象类型
+ * @param value 值,当值类型与字段类型不匹配时,会尝试转换
* @throws UtilException UtilException 包装IllegalAccessException异常
*/
public static void setFieldValue(Object obj, Field field, Object value) throws UtilException {