解決maven打包缺少依賴class xxx for user defined function to_pinyin failed to load問題

更新時間：2025年09月12日 09:23:21 作者：hammring

在使用自定義函數(shù)時因依賴缺失導致報錯,通過定位Maven打包配置發(fā)現(xiàn)缺少依賴包,解決方法是在pom.xml中添加maven-shade-plugin插件,實現(xiàn)依賴打包和類隔離,成功解決依賴加載問題

1. 問題報錯

FAILED: ODPS-0130071:[1,8] Semantic analysis exception - class xxx for user defined function xxx failed to load.
Some dependencies are missing. Detail messages are: net/sourceforge/pinyin4j/format/exception/BadHanyuPinyinOutputFormatCombination

2.問題定位

(1) 打好的jar包解壓打開發(fā)現(xiàn)確實沒有發(fā)現(xiàn)依賴，定位問題到maven打jar包顯示缺少依賴

根據(jù)查找資料發(fā)現(xiàn)，maven-shade-plugin提供了兩大基本功能：

a.將依賴的jar包打包到當前jar包（常規(guī)打包是不會將所依賴jar包打進來的）；
b.對依賴的jar包進行重命名（用于類的隔離）；

3.問題解決方法

在pom.xml中添加plugin java編譯插件。

<build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.1.0</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <filters>
                                <filter>
                                    <artifact>*:*</artifact>
                                    <!-- 這里必須要填下面這段，否則報錯 -->
                                    <excludes>
                                        <exclude>META-INF/*.SF</exclude>
                                        <exclude>META-INF/*.DSA</exclude>
                                        <exclude>META-INF/*.RSA</exclude>
                                    </excludes>
                                </filter>
                            </filters>
                            <transformers>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <!-- 下面這里要填要運行的類，否則會報錯 -->
                                    <mainClass>xxx</mainClass>
                                </transformer>
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

        </plugins>
</build>