# 1.0.3 迁移指南

[返回1.0.3目录](./api.md) | [返回主文档](../../README.md)

## 📋 迁移概述
本文档提供从我公司若依版本升级过程中可能发生的问题

## 🛠️ 故障排除
### 常见问题
#### 问题1：okhttp版本问题
症状：启动时报Unsupported OkHttp library found. Must use okhttp >= 4.11.0
原因：我们公司的若依框架，有的okhttp版本过旧
解决：参考以下
```
<dependencyManagement>
    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>4.12.0</version>
    </dependency>
    <dependency>
        <groupId>com.squareup.okio</groupId>
        <artifactId>okio</artifactId>
        <version>3.6.0</version>
    </dependency>
    <dependency>
        <groupId>com.leying</groupId>
        <artifactId>minio-spring-boot-starter</artifactId>
        <version>${ly.minio.version}</version>
        <exclusions>
            <exclusion>
                <groupId>com.squareup.okhttp3</groupId>
                <artifactId>okhttp</artifactId>
            </exclusion>
            <exclusion>
                <groupId>com.squareup.okio</groupId>
                <artifactId>okio</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencyManagement>
```
#### 问题1：okhttp版本问题
症状：启动时报Correct the classpath of your application so that it contains a single, compatible version of okhttp3.RequestBody
原因：我们公司的若依框架，有的okhttp版本过旧
解决：参考以下
```
1 修改 根pom
<dependencyManagement>
    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>4.12.0</version>
    </dependency>
    <dependency>
        <groupId>com.squareup.okio</groupId>
        <artifactId>okio</artifactId>
        <version>3.6.0</version>
    </dependency>
    <dependency>
        <groupId>com.leying</groupId>
        <artifactId>minio-spring-boot-starter</artifactId>
        <version>${ly.minio.version}</version>
        <exclusions>
            <exclusion>
                <groupId>com.squareup.okhttp3</groupId>
                <artifactId>okhttp</artifactId>
            </exclusion>
            <exclusion>
                <groupId>com.squareup.okio</groupId>
                <artifactId>okio</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencyManagement>
2 biz引入
<dependency>
    <groupId>com.leying</groupId>
    <artifactId>minio-spring-boot-starter</artifactId>
</dependency>
<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
</dependency>
```



## 回滚方案
## 📞 支持与帮助
### 获取帮助
文档：1.0.3完整文档
GitHub Issues：问题反馈
邮件支持：syfei49@163.com
### 紧急联系方式
运维团队：+86-15637937720
技术支持：syfei49@163.com
值班表：tech-support-schedule.pdf

## 🔗 相关文档
[1.0.3 API文档](../v1.0.3/api.md)
[1.0.3配置文档](../v1.0.3/config.md)
版本对比
更新日志
[返回主文档](../../README.md)

*迁移指南版本: 1.0.3 | 最后更新: 2025-12-05*