第09篇:Spring处理Mybatis事务

举报
西魏陶渊明 发表于 2022/09/25 00:33:18 2022/09/25
【摘要】 提示 本篇文章是对Mybatis知识点的一个扩展,主要一起来研究下Spring是如何来管理事务的。顺便再多聊一点其他的知识点,在学习的过程中主要带着以下问题来进行有目的的学习 然后最终来回答下面这些问题。 Mybatis是如何整合进Spring中的 Spring如何知道哪些接口是Mapper接口的?...

提示

本篇文章是对Mybatis知识点的一个扩展,主要一起来研究下Spring是如何来管理事务的。顺便再多聊一点其他的知识点,在学习的过程中主要带着以下问题来进行有目的的学习 然后最终来回答下面这些问题。

  1. Mybatis是如何整合进Spring中的
    • Spring如何知道哪些接口是Mapper接口的?
    • Mapper接口是如何变成Spring Bean的?
  2. Spring在哪里声明的SqlSession的实现逻辑?
  3. Spring中声明式事务的实现方式是怎样的?
  4. Spring中如何处理嵌套事务的?
  5. Spring中事务的传播方式是如何实现的?

https://cloud.tencent.com/developer/article/1497631

# 一、如何整合进Spring中的

默认大家对Spring都比较了解了,这里只说结果。都知道接口是不能被实例化的,那么接口是如何成为Bean的呢?

# 1.1 如何知道哪些是Mybatis的接口呢?

  • @MapperScan Spring中在配置类上加上这个注解。根据源码能看到还导入了MapperScannerRegistrar

    
  1. @Retention(RetentionPolicy.RUNTIME)
  2. @Target(ElementType.TYPE)
  3. @Documented
  4. @Import(MapperScannerRegistrar.class)
  5. @Repeatable(MapperScans.class)
  6. public @interface MapperScan {}
  7. public class MapperScannerRegistrar implements ImportBeanDefinitionRegistrar, ResourceLoaderAware {}
12345678

MapperScannerRegistrar 会在配置类解析时候拿到MapperScan注解信息,并解析里面的参数。生成一个 MapperScannerConfigurer 信息。 从源码中能看到Mybatis的很多配置信息,都会被注入到MapperScannerConfigurer中。

a890a86b9968f062797adca4da5958ea.png


    
  1. public class MapperScannerConfigurer
  2. implements BeanDefinitionRegistryPostProcessor, InitializingBean, ApplicationContextAware, BeanNameAware {}
12

实现自BeanDefinitionRegistryPostProcessor会前置,拿到MapperScan中的basePackage,最终通过ClassPathMapperScanner扫描并添加到 BeanDefinitionRegistry中。

e7ea77627555ddd1f72ec70e190e7bd0.png

到这里这种方式就能知道哪些是Mybatis中的Mapper接口了。

还有第二种方式当发现Spring容器中没有MapperScannerConfigurer。会自动注入一个

15483d355653cabf0f77dc524c15cdc2.png

会直接指定哪些类被Mapper修饰,就将他生成Bean。 1fbdecd3ce6d193903568b65213c0170.png

好了,到这里就知道如何来确定那些接口是要生成Mybatis接口的了。下面看下个问题。

# 1.2 Mapper接口是如何变成Spring Bean的?

接口是不能被实例化的,但是在Spring中如何想让接口实例化就可以使用 FactoryBean + 动态代理的方式,实现接口类的实例化。

  • 首先利用 ClassPathBeanDefinitionScanner 找到符合规则的类生成 BeanDefinition。
  • 给 BeanDefinition 指定BeanClass,执行 FactoryBean 是 MapperFactoryBean

fd300d1eeffa8234cad30a2782eca749.png

# 二、Spring在哪里声明的SqlSession的实现逻辑?

通过Mybatis的学习知道SqlSession一共有2个包装类。SqlSessionManager和SqlSessionTemplate。那么SqlSession是在哪里指定用哪个的呢? 答案就在 MapperFactoryBean


    
  1. public class MapperFactoryBean<T> extends SqlSessionDaoSupport implements FactoryBean<T> {
  2. private SqlSessionTemplate sqlSessionTemplate;
  3. public void setSqlSessionFactory(SqlSessionFactory sqlSessionFactory) {
  4. if (this.sqlSessionTemplate == null || sqlSessionFactory != this.sqlSessionTemplate.getSqlSessionFactory()) {
  5. this.sqlSessionTemplate = createSqlSessionTemplate(sqlSessionFactory);
  6. }
  7. }
  8. @SuppressWarnings("WeakerAccess")
  9. protected SqlSessionTemplate createSqlSessionTemplate(SqlSessionFactory sqlSessionFactory) {
  10. return new SqlSessionTemplate(sqlSessionFactory);
  11. }
  12. }
1234567891011121314

# 三、Spring中声明式事务的实现方式是怎样的

看了Mybatis中事务这一章节,知道如果使用了SqlSessionTemplate,那么事务的权限就外包给了Spring。那么Spring中事务怎么处理的呢? 终于进入正题了。Spring中提供两种事务的能力。

  • 声明式事务
  • 编程式事务

# 3.1 声明式事务

使用 Transactional 修饰方法,其主要实现是使用切面实现。

  • TransactionAspectSupport#invokeWithinTransaction。拦截方法。获取事务管理器。

这里我们先来思考下,通过前面的学习知道事务的最底层实现是jdbc驱动来实现的。

dd4216f9768cb7e321e4402cf77fefb0.png

那么切面中要想实现,就必须保证切面中的线程执行的数据库操作,一定是同一个SqlSession这样才能在方法正常执行时候做commit,异常时候做rollback操作。

bc4a31133eec765889727edbc6c41145.png

那我们看下他是如何保证切面中的数据库操作一定是同一个SqlSession的吧。这部分逻辑就在 SqlSessionTemplate 中。

c797922669303d597062c39a7ad6b39b.png

  • 获取当前线程是否已经有SqlSession了,如果有就直接使用,这样就保证在切面中的事务用的是同一个事务了。

# 3.2 编程式事务

  • TransactionTemplate#execute

编程是事务需要实现者自己来管理事务的,Spring提供的扩展接口类是 CallbackPreferringPlatformTransactionManager。如果发现容器中默认的事务管理类是这个 就直接调动全局的这个事务管理方法。如果不是就自己来处理。这种设计的好处是,事务管理器既可以做关系型数据库的事务管理,也可以满足一些特定场景的事务控制(eg: 给Kafka的逻辑做一个事务管理)。

8f944e303a5694c225446381a25ca019.png

# 四、Spring中如何处理嵌套事务的?

什么是嵌套事务,举一个伪代码的例子。下面 saveUser 代码中有2个Mapper。但是有几个SqlSession呢?


    
  1. UserMapper userMapper;
  2. RegistroyMapper registoryMapper;
  3. @Transactional(rollbackFor = {Throwable.class, RuntimeException.class, ExecutionException.class})
  4. public void save(User user){
  5. userMapper.save(user);
  6. }
  7. @Transactional(rollbackFor = {Throwable.class, RuntimeException.class, ExecutionException.class})
  8. public void saveUser(String userName,Strign password){
  9. User user = registoryMapper.regis(userName,password);
  10. save(user);
  11. }
1234567891011121314

通过上面的学习我们了解到如果是Spring来管理的事务是一个线程对应一个SqlSession。所以说上面伪代码中的两个Mapper 其实是用的同一个SqlSession,这样才能保证是在同一个事务中。核心代码逻辑就在这里 SqlSessionUtils#getSqlSession。 从Spring中的事务管理器中获取 SqlSession。是否使用同一个事务,外包给Spring容器去托管。这就给Spring提供了很多可以发挥的空间。 比如说传播机制等。


    
  1. public static SqlSession getSqlSession(SqlSessionFactory sessionFactory, ExecutorType executorType,
  2. PersistenceExceptionTranslator exceptionTranslator) {
  3. notNull(sessionFactory, NO_SQL_SESSION_FACTORY_SPECIFIED);
  4. notNull(executorType, NO_EXECUTOR_TYPE_SPECIFIED);
  5. SqlSessionHolder holder = (SqlSessionHolder) TransactionSynchronizationManager.getResource(sessionFactory);
  6. SqlSession session = sessionHolder(executorType, holder);
  7. if (session != null) {
  8. return session;
  9. }
  10. LOGGER.debug(() -> "Creating a new SqlSession");
  11. session = sessionFactory.openSession(executorType);
  12. registerSessionHolder(sessionFactory, executorType, exceptionTranslator, session);
  13. return session;
  14. }
1234567891011121314151617181920

# 五、Spring中事务的传播方式是如何实现的?

传播方式 说明 常用
TransactionDefinition.PROPAGATION_REQUIRED 如果存在一个事务,则支持当前事务。如果没有事务则开启
TransactionDefinition.PROPAGATION_SUPPORTS 如果存在一个事务,支持当前事务。如果没有事务,则非事务的执行  
TransactionDefinition.PROPAGATION_MANDATORY 如果已经存在一个事务,支持当前事务。如果没有一个活动的事务,则抛出异常  
TransactionDefinition.PROPAGATION_NEVER 总是非事务地执行,如果存在一个活动事务,则抛出异常  
TransactionDefinition.PROPAGATION_NOT_SUPPORTED 总是非事务地执行,并挂起任何存在的事务  
TransactionDefinition.PROPAGATION_REQUIRES_NEW 总是开启一个新的事务。如果一个事务已经存在,则将这个存在的事务挂起。  
TransactionDefinition.PROPAGATION_NESTED 如果一个活动的事务存在,则运行在一个嵌套的事务中. 如果没有活动事务则按TransactionDefinition.PROPAGATION_REQUIRED 属性执行  

思考传播机制如何实现

首先我们先思考下传播机制是如何实现的,因为我们知道 要保证是同一个事务,那么一定是同一个SqlSession,这样才能保证是同一个事务。 而如果要新开事务,就要先将当前线程绑定的SqlSession等事务信息,给挂起,那么是如何进行挂起的呢? SqlSession又是如何跟线程绑定的呢?

# 5.1 SqlSession是如何跟线程绑定的呢?

通过TransactionSynchronizationManager中的ThreadLocal跟线程绑定(new NamedThreadLocal<>("Transactional resources"))。注意: 如果主线程下创建子线程是不能绑定上的。


    
  1. private static void registerSessionHolder(SqlSessionFactory sessionFactory, ExecutorType executorType,
  2. PersistenceExceptionTranslator exceptionTranslator, SqlSession session) {
  3. SqlSessionHolder holder = new SqlSessionHolder(session, executorType, exceptionTranslator);
  4. TransactionSynchronizationManager.bindResource(sessionFactory, holder);
  5. TransactionSynchronizationManager
  6. .registerSynchronization(new SqlSessionSynchronization(holder, sessionFactory));
  7. holder.setSynchronizedWithTransaction(true);
  8. holder.requested();
  9. }
123456789

# 5.2 事务是如何嵌套的?

答案就在 TransactionAspectSupport#TransactionInfo 中。一个事务注解对应一个TransactionInfo,如果出现嵌套 就会生成一个事务链。如下图一样。

9689fb7f8fde0d19c6821cd6b461cdf0.png

当里层的事务处理完成后会执行清理动作,同时在将第一个的事务在进行恢复跟线程绑定。


    
  1. private void restoreThreadLocalStatus() {
  2. // Use stack to restore old transaction TransactionInfo.
  3. // Will be null if none was set.
  4. transactionInfoHolder.set(this.oldTransactionInfo);
  5. }
12345

# 5.3 事务是如何挂起的?

前面知道每一个 @Transaction 注解会对应一个 TransactionAspectSupport#TransactionInfo。而事务挂起后,会先跟线程进行解绑。 然后挂起的事务 SuspendedResourcesHolder 会被添加在 TransactionStatus 中。

挂起的数据保存在哪里


    
  1. protected final class TransactionInfo {
  2. // 事务管理器
  3. @Nullable
  4. private final PlatformTransactionManager transactionManager;
  5. // 事务信息
  6. @Nullable
  7. private final TransactionAttribute transactionAttribute;
  8. // 切面点
  9. private final String joinpointIdentification;
  10. // DefaultTransactionStatus
  11. @Nullable
  12. private TransactionStatus transactionStatus;
  13. @Nullable
  14. private TransactionInfo oldTransactionInfo;
  15. }
  16. public class DefaultTransactionStatus extends AbstractTransactionStatus {
  17. @Nullable
  18. private final Object transaction;
  19. private final boolean newTransaction;
  20. private final boolean newSynchronization;
  21. private final boolean readOnly;
  22. private final boolean debug;
  23. @Nullable
  24. private final Object suspendedResources;
  25. }
1234567891011121314151617181920212223242526

如何进行挂起的

TransactionSynchronization 事务同步器,为了解决事务的传播方式

  • suspend 暂定事务,将事务从当前线程上解绑
  • resume 恢复事务,将事务从新恢复到当前线程上
  • beforeCommit 触发提交事务,执行commit
  • beforeCompletion 事务提交后
  • afterCommit 提交后
  • afterCompletion 完成后调用

SqlSessionSynchronization 也是跟当前线程绑定的

  • 位置 TransactionSynchronizationManager#ThreadLocal<Set<TransactionSynchronization>> synchronizations

    
  1. // 挂起时候,将SqlSessionHolder与当前线程进行解绑
  2. @Override
  3. public void suspend() {
  4. if (this.holderActive) {
  5. LOGGER.debug(() -> "Transaction synchronization suspending SqlSession [" + this.holder.getSqlSession() + "]");
  6. TransactionSynchronizationManager.unbindResource(this.sessionFactory);
  7. }
  8. }
  9. /**
  10. * 恢复时候重新跟当前线程绑定
  11. */
  12. @Override
  13. public void resume() {
  14. if (this.holderActive) {
  15. LOGGER.debug(() -> "Transaction synchronization resuming SqlSession [" + this.holder.getSqlSession() + "]");
  16. TransactionSynchronizationManager.bindResource(this.sessionFactory, this.holder);
  17. }
  18. }
12345678910111213141516171819

# 5.4 传播方式具体实现

下面这段代码就是事务注解的切面处理类,Spring事务的所有逻辑和扩展支持都在这里。

  • TransactionAspectSupport#invokeWithinTransaction

首先我们先看整体的逻辑

  1. 获取当切面上的 @Transaction 注解信息
  2. 根据注解信息找到指定的事务管理器,如果没有执行就使用默认的
  3. 生成事务信息 TransactionInfo 传播机制,事务挂起都在这个类上
  4. 失败执行回滚&成功提交&如果是嵌套事务,从TransactionInfo 中将挂起的事务重新跟线程进行绑定

    
  1. protected Object invokeWithinTransaction(Method method, @Nullable Class<?> targetClass,
  2. final InvocationCallback invocation) throws Throwable {
  3. // If the transaction attribute is null, the method is non-transactional.
  4. TransactionAttributeSource tas = getTransactionAttributeSource();
  5. // 获取被事务注解标记的事务信息
  6. final TransactionAttribute txAttr = (tas != null ? tas.getTransactionAttribute(method, targetClass) : null);
  7. // 根据事务注解上指定的事务管理器名称,去系统中获取,如果没有就拿系统中默认的事务管理器
  8. final PlatformTransactionManager tm = determineTransactionManager(txAttr);
  9. // 切面拦截点: com.alibaba.purchase.domain.replenish.impl.ReplenishDomainWriteServiceImpl.mockSave
  10. final String joinpointIdentification = methodIdentification(method, targetClass, txAttr);
  11. // 这里只看关系型数据的的事务逻辑。CallbackPreferringPlatformTransactionManager是具有回调性质的事务管理器,多用于处理自定的事务
  12. if (txAttr == null || !(tm instanceof CallbackPreferringPlatformTransactionManager)) {
  13. // Standard transaction demarcation with getTransaction and commit/rollback calls.
  14. // 获取事务的信息,包含传播方式
  15. TransactionInfo txInfo = createTransactionIfNecessary(tm, txAttr, joinpointIdentification);
  16. Object retVal = null;
  17. try {
  18. // This is an around advice: Invoke the next interceptor in the chain.
  19. // This will normally result in a target object being invoked.
  20. retVal = invocation.proceedWithInvocation();
  21. }
  22. catch (Throwable ex) {
  23. // target invocation exception
  24. completeTransactionAfterThrowing(txInfo, ex);
  25. throw ex;
  26. }
  27. finally {
  28. cleanupTransactionInfo(txInfo);
  29. }
  30. commitTransactionAfterReturning(txInfo);
  31. return retVal;
  32. }
  33. }
12345678910111213141516171819202122232425262728293031323334

这里只看传播机制吧。AbstractPlatformTransactionManager#handleExistingTransaction

  • TransactionDefinition.PROPAGATION_NEVER 如果存在事务就报错
  • TransactionDefinition.PROPAGATION_NOT_SUPPORTED 如果有事务,就挂起(当前事务跟线程解绑)。不使用事务进行执行。
  • TransactionDefinition.PROPAGATION_REQUIRES_NEW 当前事务挂起,新开个事务。

    
  1. /**
  2. * Create a TransactionStatus for an existing transaction.
  3. */
  4. private TransactionStatus handleExistingTransaction(
  5. TransactionDefinition definition, Object transaction, boolean debugEnabled)
  6. throws TransactionException {
  7. // TransactionDefinition.PROPAGATION_NEVER(总是非事务地执行,如果存在一个活动事务,则抛出异常)就直接阻断报错
  8. if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NEVER) {
  9. throw new IllegalTransactionStateException(
  10. "Existing transaction found for transaction marked with propagation 'never'");
  11. }
  12. // TransactionDefinition.PROPAGATION_NOT_SUPPORTED 总是非事务地执行,并挂起任何存在的事务
  13. if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NOT_SUPPORTED) {
  14. if (debugEnabled) {
  15. logger.debug("Suspending current transaction");
  16. }
  17. Object suspendedResources = suspend(transaction);
  18. boolean newSynchronization = (getTransactionSynchronization() == SYNCHRONIZATION_ALWAYS);
  19. // 数据暂存在TransactionSynchronizationManager#synchronizations同步器中
  20. return prepareTransactionStatus(
  21. definition, null, false, newSynchronization, debugEnabled, suspendedResources);
  22. }
  23. // 总是开启一个新的事务。如果一个事务已经存在,则将这个存在的事务挂起。
  24. if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_REQUIRES_NEW) {
  25. if (debugEnabled) {
  26. logger.debug("Suspending current transaction, creating new transaction with name [" +
  27. definition.getName() + "]");
  28. }
  29. SuspendedResourcesHolder suspendedResources = suspend(transaction);
  30. try {
  31. boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
  32. DefaultTransactionStatus status = newTransactionStatus(
  33. definition, transaction, true, newSynchronization, debugEnabled, suspendedResources);
  34. doBegin(transaction, definition);
  35. prepareSynchronization(status, definition);
  36. return status;
  37. }
  38. catch (RuntimeException | Error beginEx) {
  39. resumeAfterBeginException(transaction, suspendedResources, beginEx);
  40. throw beginEx;
  41. }
  42. }
  43. // 如果有事务存在,则运行在一个嵌套的事务中. 如果没有活动事务则按TransactionDefinition.PROPAGATION_REQUIRED 属性执行
  44. if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NESTED) {
  45. if (!isNestedTransactionAllowed()) {
  46. throw new NestedTransactionNotSupportedException(
  47. "Transaction manager does not allow nested transactions by default - " +
  48. "specify 'nestedTransactionAllowed' property with value 'true'");
  49. }
  50. if (debugEnabled) {
  51. logger.debug("Creating nested transaction with name [" + definition.getName() + "]");
  52. }
  53. if (useSavepointForNestedTransaction()) {
  54. // Create savepoint within existing Spring-managed transaction,
  55. // through the SavepointManager API implemented by TransactionStatus.
  56. // Usually uses JDBC 3.0 savepoints. Never activates Spring synchronization.
  57. DefaultTransactionStatus status =
  58. prepareTransactionStatus(definition, transaction, false, false, debugEnabled, null);
  59. // 使用当前事务,并增加当前事务的一次引用。
  60. status.createAndHoldSavepoint();
  61. return status;
  62. }
  63. else {
  64. // Nested transaction through nested begin and commit/rollback calls.
  65. // Usually only for JTA: Spring synchronization might get activated here
  66. // in case of a pre-existing JTA transaction.
  67. // 没有新建一个事务
  68. boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
  69. DefaultTransactionStatus status = newTransactionStatus(
  70. definition, transaction, true, newSynchronization, debugEnabled, null);
  71. doBegin(transaction, definition);
  72. prepareSynchronization(status, definition);
  73. return status;
  74. }
  75. }
  76. // Assumably PROPAGATION_SUPPORTS or PROPAGATION_REQUIRED.
  77. if (debugEnabled) {
  78. logger.debug("Participating in existing transaction");
  79. }
  80. if (isValidateExistingTransaction()) {
  81. if (definition.getIsolationLevel() != TransactionDefinition.ISOLATION_DEFAULT) {
  82. Integer currentIsolationLevel = TransactionSynchronizationManager.getCurrentTransactionIsolationLevel();
  83. if (currentIsolationLevel == null || currentIsolationLevel != definition.getIsolationLevel()) {
  84. Constants isoConstants = DefaultTransactionDefinition.constants;
  85. throw new IllegalTransactionStateException("Participating transaction with definition [" +
  86. definition + "] specifies isolation level which is incompatible with existing transaction: " +
  87. (currentIsolationLevel != null ?
  88. isoConstants.toCode(currentIsolationLevel, DefaultTransactionDefinition.PREFIX_ISOLATION) :
  89. "(unknown)"));
  90. }
  91. }
  92. if (!definition.isReadOnly()) {
  93. if (TransactionSynchronizationManager.isCurrentTransactionReadOnly()) {
  94. throw new IllegalTransactionStateException("Participating transaction with definition [" +
  95. definition + "] is not marked as read-only but existing transaction is");
  96. }
  97. }
  98. }
  99. //
  100. boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
  101. return prepareTransactionStatus(definition, transaction, false, newSynchronization, debugEnabled, null);
  102. }
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103

# 5.5 嵌套事务如何知道是否要提交

当两个Mapper中使用的是同一个SqlSession,那么会不会第二个事务在执行后,就直接commit了呢,此时第一个事务有一次commit。导致异常呢?

解决方案在这里 DefaultTransactionStatus

第二个事务状态中

  • newTransaction = false
  • newSynchronization = false 9ea6ac45009eb34647c364d409d5a282.png

而下面代码中会做校验,只需要同步时候才会提交事务。


    
  1. protected final void triggerBeforeCommit(DefaultTransactionStatus status) {
  2. if (status.isNewSynchronization()) {
  3. if (status.isDebug()) {
  4. logger.trace("Triggering beforeCommit synchronization");
  5. }
  6. TransactionSynchronizationUtils.triggerBeforeCommit(status.isReadOnly());
  7. }
  8. }
12345678

第一个事务状态中

  • newTransaction = true
  • newSynchronization = true 才会真正的去执行。 c8e4574fa31d4a11b09620e9d5bc4d93.png

# 5.6 这样设计是否线程安全

线程安全只有在多线程环境下才会出现。那么这里一定会有多线程问题。而事务是跟线程进行绑定的,所以这里虽然有多线程但是不会有线程安全问题。

但是这里我们看源码线程绑定时候使用的ThreadLocal,所以你在线程中创建子线程或者是线程中使用线程池,这里的事务都不会共享的。

 

文章来源: springlearn.blog.csdn.net,作者:西魏陶渊明,版权归原作者所有,如需转载,请联系作者。

原文链接:springlearn.blog.csdn.net/article/details/125858031

【版权声明】本文为华为云社区用户转载文章,如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。